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PRELIMINARY AMENDMENT 

Honorable Commissioner of Patents 

and Trademarks 
Washington, D.C. 20231 

Sir: 

Please amend the subject application, filed concurrently herewith, as indicated 

below: 

IN THE SPECIFICATION : 

After the title and before the first paragraph on page 1 , insert the following 
headings: 
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-BACKGROUND OF THE INVENTION 
- FIELD OF THE INVENTION- : 

Page 1 , after the first paragraph and before the second paragraph at line 1 1 , 
insert the following heading at the left-hand margin: 
- DESCRIPTION OF RELATED ART- : 

Page 2, line 4, delete "processes (BBL)" and substitute -bulletin board liaison 
(BBL) processes-; 

Page 2, line 7, before "machine", insert -slave-; 

Page 2, line 8, before "machine", insert -slave-; 

Page 2, line 8, before "process", insert -bulletin board liaison- and after 
"process", delete "called"; 

Page 2, line 9, before "The bridge", insert a paragraph break. 

Page 4, at line 17, before the paragraph beginning "The object..." , insert the 
following heading at the left-hand margin: 
- SUMMARY OF THE INVENTION- : 

Page 6, at line 12, and before the paragraph beginning " Other characteristics...", 
insert the following heading at the left-hand margin: 
- BRIEF DESCRIPTION OF THE DRAWINGS- : 
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Page 7, before line 8, and before the paragraph beginning "The following 
insert the following heading at the left hand margin: 
- DESCRIPTION OF THE PREFERRED EMBODIMENTrSW : 

Page 7, line 1 1 , change "six" to -seven-; 

Page 7, line 12, before "network", insert -routing and-; 

Page 27, delete lines 32 and 33 in their entirety, and substitute the following new 
paragraph: 

-While this invention has been described in conjunction with specific 
embodiments thereof, it is evident that many alternatives, modifications and variations 
will be apparent to those skilled in the art. Accordingly, the preferred embodiments of 
the invention as set forth herein, are intended to be illustrative, not limiting. Various 
changes may be made without departing from the spirit and scope of the invention as 
set forth herein and defined in the claims.- 
IN THE CLAIMS : 

Please cancel claims 1 - 12 in their entirety and without prejudice and substitute 
the following new claims: 

1 -1 3. A process for assisting in the administration of a distributed application of 

2 a transaction processing manager, based on a binary configuration file (TUXCONFIG), 

3 characterized in that said process comprises: 
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4 - retrieving information related to said distributed application in a configuration 

5 file of a master machine (Mm), and 

6 - checking the consistency of said application running on a given machine. 

7 14. A process according to claim 13, characterized in that it further comprises 

8 a step for managing at least one listener module (3) of any machine of the application 

9 from another machine. 

1 16. A process according to claim 13, characterized in that it further comprises 

2 extracting directly from the active configuration file of the master machine information 

3 related to said distributed application. 

1 16. A process according to claim 13, characterized in that the step for 

2 checking the consistency of said application consists of comparing the information 

3 obtained from the configuration file of the master machine and the information obtained 

4 from said current application running on a given machine. 

1 17. A process according to claim 14, characterized in that said administration 

2 of listener modules consists of starting and stopping at least one listener module, 
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3 displaying information related to at least one listener module, changing the log of at 

4 least one listener module, checking the script of at least one listener module and/or 

5 updating the script of at least one listener module. 

1 18. A process according to claim 14, characterized in that it further comprises 

2 a step for starting and stopping a listener module running on a first machine, said step 
for starting and stopping being carried out by an administrator using a second machine 

4 distinct from first machine, but belonging to the same network as the first machine. 

Ill 1 19. A process according to claim 14, characterized in that it further comprises 

= 2 a step for simultaneously activating several listener modules. 

5 20. A process according to claim 14, characterized in that it further comprises 

2 a step for decompiling the active configuration file of the master machine. 

1 21 . A process according to claim 14, including a graphical interface 

2 comprising at least one icon, at least one menu and at least one dialog box for 

3 implementing the start and stop of a listener module and the retrieval of information and 

4 checking the consistency of said application running on a given machine. 
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1 22. A process according to claim 21 , characterized in that the menus of the 

2 graphical interface are structured in tree form and the activation of a menu results in a 

3 display of a list of values of the current configuration, selectable by the user. 

1 23. A process according to claim 16, further including automatically 

2 generating a file containing information on said application running on a given machine 

3 (tlog) when the file does not exist in a given machine In order to be able use it during 

4 the next startup of the listener modules (3). 

1 24. A process according to claim 18, characterized in that information related 

2 to at least one listener module (3) is displayed and comprises at least the name of said 

3 application, the logical name of the machine (LMID) on which said application is run, 

4 the identification of the user (UID) of said application, the address used by the listener 

5 module (NLSADDR), the access path to the network of said application, and the access 

6 path to a log file of said listener module (LLFPN).- 
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1 25. A process according to claim 14, characterized in that information related 

2 to at least one listener module (3) is displayed and comprises at least the name of said 

3 application, the logical name of the machine (LMID) on which said application is run, 

4 the identification of the user (DID) of said application, the address used by the listener 

5 module (NLSADDR), the access path to the network of said application, and the access 

6 path to a log file of said listener module (LLFPN).- 

1 26. A process according to claim 17, characterized in that information related 

2 to at least one listener module (3) is displayed and comprises at least the name of said 

3 application, the logical name of the machine (LMID) on which said application is run, 

4 the identification of the user (UID) of said application, the address used by the listener 

5 module (NLSADDR), the access path to the network of said application, and the access 

6 path to a log file of said listener module (LLFPN).- 

1 27. A process according to claim 1 9, characterized in that information related 

2 to at least one listener module (3) is displayed and comprises at least the name of said 

3 application, the logical name of the machine (LMID) on which said application is run, 

4 the identification of the user (UID) of said application, the address used by the listener 
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5 module (NLSADDR), the access path to the network of said application, and the access 

6 path to a log file of said listener module (LLFPN).- 

1 28. A process according to claim 22, characterized in that information related 

2 to at least one listener module (3) is displayed and comprises at least the name of said 

3 application, the logical name of the machine (LMID) on which said application is run, 

4 the identification of the user (UID) of said application, the address used by the listener 

5 module (NLSADDR), the access path to the network of said application, and the access 

6 path to a log file of said listener module (LLFPN).- 

1 29. A process according to claim 21 , characterized in that information related 

2 to at least one listener module (3) is displayed and comprises at least the name of said 

3 application, the logical name of the machine (LMID) on which said application is run, 

4 the identification of the user (UID) of said application, the address used by the listener 

5 module (NLSADDR), the access path to the network of said application, and the access 

6 path to a log file of said listener module (LLFPN). 

1 30. A process according to claim 23, characterized in that information related 

2 to at least one listener module (3) is displayed and comprises at least the name of said 

3 application, the logical name of the machine (LMID) on which said application is run, 
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4 the identification of the user (UID) of said application, the address used by the listener 

5 module (NLSADDR), the access path to the network of said application, and the access 

6 path to a log file of said listener module (LLFPN).- 



IN THE ABSTRACT: 

Please cancel the Abstract at page 29 in its entirety and substitute the following 
new Abstract: 
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1 "ABSTRACT 

2 The present invention relates to a process for assisting in the administration of a 

3 distributed application of a transaction processing manager based on a binary 

4 configuration file (TUXCONFIG), characterized in that said process comprises: 

5 - decompiling the active configuration file of the master machine (Mm), 
;06 - retrieving information from the decompiled configuration file of the master 
pj machine, and 

[58 - checking the consistency of said application running on said given machine, 

r 9 Information related to at least one listener module is displayed and includes at 

010 least the name of the application, the logical name of the machine (LMID) on which the 

^ 1 application is run, the identification of the user (UID) of said application, the address 

^2 used by the listener module (NLSADDR), the access path to the network of the 

13 application, and the access path to a log file of said listener module (LLFPN). If the tlog 

14 file containing information on the application running on a given machine does not exist, 

1 5 the file is automatically generated in order to be able to use the file during the next 

1 6 startup of the listener modules. 
17 
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REMARKS 

This Preliminary Amendment is filed to insert headings to confonn the 
application to U.S. practice, to correct informalities in the specification, claims and 
abstract resulting from a literal translation of the French text, and to eliminate the use of 
multiple dependent claims.. 

Early action on the merits is earnestly solicited. 

Respectfully submitted, 

KERKAM, STOWELL, 
KONDRACKI & CLARKE, P.C. 



Date: August 30. 1999 




Two Skyline Place, Suite 600 
5203 Leesburg Pike 
Falls Church, VA 22041-3401 
Telephone: (703) 998-3302 
Telefax: (703) 998-5634 

EJK:ah\anndt-pat\BAILLIF-PCT-3587-PREL-AMD 
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1 METHOD^ MDg^_ASSI STING THE ADMINISTRATION OF A DISTRIBUTED 

2 _ APPLICATION BASED ON A BINARY CONFIGURATION FILE 



3 IN A C OMPUTER SYSTEM 

< ~ " — ' — ^ 

4 

5 The present invention relates to a process for assisting in 

6 the administration of a distributed application based on a binary 

7 configuration file in a computer system. This process for 

8 assisting in the acJministration can especially be applied to a 

9 transaction processing manager like the one marketed under the 

1 0 name " Tuxedo . " 

11 The "Tuxedo" application allows different software programs 

12 that do not recognize one another, but that use a certain 
1M protocol, to work together. 

ij Generally, the "Tuxedo" application is a distributed 

1^ application, i.e., an application that runs on several machines 

1^ at the same time. A "machine" is the node of the network in which 

1J7 the servers of the "Tuxedo" application run, and the "master 

machine" is the one that controls the "Tuxedo" application. Fig. 

tM 8 illustrates the operation of the "Tuxedo" application. When the 

2# "Tuxedo" application is started up, the binary configuration file 

2T (TUXCONFIG) is loaded from the disk in the bulletin board (BB) of 

22 the master machine (Mm) . The bulletin board (BB) represents a set 

23 of data structures located in the shared memory and containing 

24 information on the transactions, the servers, the services and 

25 the clients belonging to the "Tuxedo" application. During the 

26 startup of the master machine (Mm), the bulletin board (BB) is 

27 loaded into the memory of the master machine (Mm) from a binary 

28 "Tuxedo" configuration file (TUXCONFIG) . Then, it is distributed 

29 to the slave machines (Me) by the master process of the 

30 application, called the distinguished bulletin board liaison 
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1 (DBBL) . Each machine of the application is under the control of a 

2 process called a bulletin board liaison (BBL) • The distinguished 

3 bulletin board liaison DBBL is an administrative process that 

4 communicates with the processes (BBL) to coordinate the updates 

5 of the bulletin board (BB) . The bulletin board liaison BBL is an 

6 administrative process that is responsible for maintaining an 

7 updated copy of the bulletin board (BB) in its own machine (Me) . 

8 Each machine (Me) is under the control of a process called BBL, 

9 implicitly defined by "Tuxedo." The bridge (BRIDGE) (1) is a 
10 process for managing communications between the servers of the 
1^ "Tuxedo" application. Each machine is provided with a bridge 
1^ implicitly defined by "Tuxedo." The server TMS (Transaction 

1® Manager Server) is a process that manages a validation protocol 

1^ and recovery for transactions executed by several application 

Ig servers. The listener module (tlisten, 3) is a process that 

IJ manages the messages intended for the "Tuxedo" application in a 

im given machine before the bridge process (BRIDGE) of this machine 

1^;; has been started. A listener module allows a machine to receive 

1^ information coming from other machines. A listener module is 

20 required in each machine when the application is distributed. 

21 The "Tuxedo" application is created by the construction of a 

22 binary configuration file that defines the architecture of said 

23 application (Fig. 7) . During the creation of the configuration 

24 file, an administrator defines the services (Se) provided by the 

25 application and assigns them to application servers (Sr) . The 

26 administrator then defines groups (G) and assigns a set of 

27 servers (Sr) . Finally, the administrator assigns groups (G) to a 

28 machine (M) . Each application must be given a minimum of one 

29 group (G) , one service (Se) and one server (Sr) . A machine (M) 
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1 can manage several groups (6) . 

2 After the creation of a "Tuxedo" application, this 

3 application must be administered. The object of the invention is 

4 to create a system to assist in the administration of the 

5 "Tuxedo" application. The main steps involved in the 

6 administration of a "Tuxedo" application consist of: 

7 - a step for loading the binary configuration file of the 

8 "Tuxedo" application; 

9 -a step for starting listener modules when the "Tuxedo" 
10 application is a distributed application; 

1^ - a step for starting the Tuxedo application; 

1^ - a step for controlling the application. This consists of 

IP displaying information and, if necessary, performing the required 

1^ corrections; 

-a step for stopping the application; and possibly 
1% - a step for stopping the listener modules when they have 

3|B been started. 

Ig The administration of a distributed application can quickly 

1^ become very complex. In fact, before this administration can 

20 begin, the operator must activate a listener module in each slave 

21 machine on which he wishes to act. To do this, the administrator 

22 must first consult a file containing information on the 

23 activation of the listener modules. This file is generally 

24 stored, in a place that must be remembered, in each machine. 

25 Then, with the aid of this information, the operator must 

26 activate the listener module of each machine, one by one. Thus, 

27 if the application involves ten machines, the operator must 

28 activate the listener module in each of the ten machines, then at 

29 the end of the application, deactivate the ten listener modules. 
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1 This repetitive operation is long and tedious. 

2 Each administrator has his own solution for performing these 

3 tasks. The most common solution is to store in each machine, in a 

4 place that must be remembered, scripts for activating the 

5 listener modules, and to keep a paper copy of the configuration 

6 file. The administrator must make sure that the information is up 

7 to date at all times. Each time the configuration changes, he 

8 must not forget to print out a paper copy of the configuration 

9 file and update the scripts in the slave machines. 

10 Moreover, each time the operator wants to act on an element 

1^ of an application, he must be able to quickly and accurately 

identify a given resource, such as for exsunple, when stopping the 

IM server "servel" belonging to the groiip "groxipl" in the machine 

m "machl". 

1^ When the nximber of applications increases, these manual 

1^ operations are the source of numerous errors. 

The object of the present invention is to eliminate the 

Ig drawbacks of the prior art by offering a process for assisting in 

1%: the administration of a distributed application of a transaction 

20 processing manager, based on the binary configuration file of the 

21 application, characterized in that said process comprises: 

22 - a step for decompiling the active configuration file of 

23 the master machine, 

24 - a step for retrieving information in the decompiled 

25 configuration file of the master machine (Mm) , 

26 - a step for checking the consistency of said application 

27 running on a given machine. 

2 8 According to another characteristic, said process makes it 

29 possible to manage at least one listener module (3) of any 
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1 machine of the application from another machine. 

2 According to another characteristic/ the information related 

3 to said distributed application is extracted directly from the 

4 active configuration file of the master machine. 

5 According to another characteristic, the step for checking 

6 the consistency of said application consists of a comparison 

7 between information obtained from the configuration file of the 

8 master machine and information obtained from said current 

9 application running on another machine. 

10 According to another characteristic, said management of the 

14?: listener modules makes it possible to start and stop at least one 

2M listener module, to display information related to at least one 

1^ listener module, to change the log of at least one listener 

IS module, to check the script of at least one listener module, and 

1^ to update the script of at least one listener module. 

1^ According to another characteristic, an administrator on any 

ag| machine of the network can start or stop a listener module 

3^ running on another machine of the network. 

1^ According to another characteristic, said process makes it 

20 possible to activate several listener modules in a single 

21 operation. 

22 According to another characteristic, a graphical interface 

23 facilitates the management of the listener modules. 

24 According to another characteristic, said graphical 

25 interface makes it possible to display the structure of said 

26 application and to select a desired value from a list of values 

27 for the current configuration. 

28 According to another characteristic, when the file 

29 containing information on said application running on a given 
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1 machine (tlog) does not exist, the process generates it 

2 automatically in order to be able to use it during the next 

3 startup of the listener modules (3) . 

4 According to another characteristic, said displayed 

5 information related to at least one listener module comprises at 

6 least the neucie of said application, the logical name of the 

7 machine (LMID) on which said application is run, the 

8 identification of the administrator (UID) of said application, 

9 the address used by the listener module (NLSADDR) , the access 
10 path to the network of said application, and the access path to 
14i; the log file of said listener module (LLFPN) . 

Other characteristic and advantages of the present invention 

iM will emerge more clearly with the reading of the following 

l^j description given in reference to the attached drawings, in 

1%^ which: 

1^ - Fig. 1 represents a window of the graphical interface that 

ig offers access to the main commands for managing the modules; 
3^ - Fig. 2 represents a window of the graphical interface 

W according to Fig. 1 that makes it possible to activate one or 

20 more listener modules; 

21 - Fig. 3 represents a window of the graphical interface 

22 according to Fig. 1 that makes it possible to stop one or more 

23 listener modules; 

24 - Fig. 4 represents a window of the graphical interface 

25 according to claim 1 that makes it possible to display 

26 information related to a listener module of a given application; 

27 - Fig, 5 represents a window of the graphical interface 

28 according to claim 1 that makes it possible to check the script 

29 of a listener module of a given application; 
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1 - Fig. 6 represents a window of the graphical interface 

2 according to claim 1 that makes it possible to update the script 

3 of a listener module in a given machine of a given application; 

4 - Fig. 7 represents the general structure of a distributed 

5 application of a transaction processing manager; 

6 - Fig, 8 represents an exemplary application of a 

7 transaction processing manager, 

8 The following is a non-limiting exemplary specification of a 

9 configuration file. This configuration file, presented in 

10 Appendix 1, relates to the "Tuxedo" application. It is divided 

1^ into six sections (resources, machines, groups, servers, 

1^ services, network) . 

iW The resources section contains general information related 

14i to the application. This information is common to all the 

3^ machines and is constituted by the following parameters: 

1^ - IPCKEY, which represents a digital key identifying the 

1® shared memory segment in which the application structures are 

3g stored. Thanks to this digital key, a given application cannot be 

l^g in conflict with other applications; 

20 - MASTER, which represents the master machine; 

21 - DOMAINID, which represents the domain of the application; 

22 - HAXACCESSERS, which defines the maximiim niunber of people 

23 that can access the application; 

24 - MAXSERVERS, which defines the maximum number of servers 

25 that can be connected with the application; 

26 - MAXSERVICES, which defines the maximum number of services 

27 that can be connected with the application; 

2 8 - OPTIONS, which makes it possible to indicate whether the 

29 application is running in a local area network; 
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1 - MODEL, which makes it possible to indicate whether the 

2 application is or is not distributed. 

3 The machines section contains information on each machine 

4 (puce, trifide, zig, orage) of the network. This information is 

5 constituted by the following parameters: 

6 - LMID (Logical Machine ID) , which defines the logical name 

7 of the machine, i.e., the name used internally by the application 

8 in place of the network name; 

9 - TUXDIR, which specifies the access path to the 
10 installation directory of the "Tuxedo" software; 

1& - APPDIR, which specifies the access path to the application 

1^ servers, i.e., the path leading to the programs of the 

IM application {for example, the programs related to the "TUXEDO" 

iS application) ; 

- TUXCONFIG, which specifies the absolute access path to the 

K binary configuration file TUXCONFIG, which contains information 

111 on the application; 

ijft - ENVFILE, which specifies the access path to the file 

IW containing the environment variables for the servers and the 

20 clients of a given machine; 

21 - ULOGPFX/ which specifies the access path to the file 

22 "ULOG", which contains information on the history of the 

23 application. 

24 The groups section is the section in which each machine is 

25 assigned to a group. In the example of Appendix 1, there are four 

26 groups. A group is a set of servers that provide related 

27 services. In the simplest case, a group is constituted by only 
2 8 one server. All the servers of a group must run on the same 

29 machine. An application must comprise at least one group. 
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1 The servers section provides information on each server. A 

2 server is a module that provides services. In the example of 

3 Appendix 1, there are four servers. In the simplest case, a 

4 server provides only one service. An application must be provided 

5 with at least one server. The server section provides the 

6 following information: 

7 - SRVGRP, which defines the group with which the server is 

8 affiliated; 

9 - SRVID, which defines the identification number of the 
10 server; 

Ig - MIN, MAX, which indicates the maximum and minimum 

12! occurrences of this server; 

iM - RQADDR, which defines the name of the message queue used 

Iflj for the sending of a message; 

- in REPLYQ, the administrator decides on the existence of a 
1^ response queue; 

- CLOPT, which indicates the startup options of the server 
ijl (available services, priority, etc.). 

t§ In the services section, the administrator can specify the 

2 0 services. A service is a set of functions that respond to service 

21 requests issued by end users of the application. If the 

22 administrator wishes to indicate optional values that are 

23 different from the default values, the services must necessarily 

24 be defined. 

25 The network section contains, for each machine: 

26 - the complete address used by the bridge process (BRIDGE) , 

27 called the "Network Address" or "NADDR" . The first four digits 

28 (0002 in the example of Fig. 4) represent the communication 

29 protocol used ("tcp" in the above example) . The next four digits 
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1 represent the port number used by the process and the subsequent 

2 digits represent the network address of the machine; 

3 - the access path to the bridge (BRIDGE) of the machine. The 

4 bridge is a process for managing communications between the 

5 servers of the application. It is used to boot up the 

6 application. Each machine is provided with a bridge. 

7 - the complete address of the listener module, called 

8 "NLSADDR" . The first four digits represent the communication 

9 protocol used. The next four digits represent the port niimber 

10 used by the listener module, which must be different from the one 

1^: used by the bridge process (BRIDGE) . The stibsequent digits 

ll^ represent the network address of the machine. 

1^^ The essential characteristic of the invention is that the 

ifly information related to the application is extracted directly from 

the active file of the master machine. An administrator on any 

1^ machine of the network can control the execution of the command 

1® "get_t-uxval" in the master machine belonging to the 

]^ administrator, as represented on page [27] of Appendix 2. 
1^' The subroutine "get_tuxconf ig" of the progrsim used in the 

20 implementation of the process for assisting in the administration 

21 of a distributed application searches on the hard disk of the 

22 master machine for the active configuration file of the 

23 application. The latter is then decompiled by means of the 

24 command "tmunloadcf" (Page [28] of Appendix 2), lines 85 through 

25 99. 
26 

27 get_tuxconf ig 0 { 

28 if [ -s tuxconf • tmp.$appname ] 

2 9 then 

3 0 cat tuxconf . tmp . $appname 
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1 else 

2 rm - f tuxconf . tmp . * 

3 prog="$Env"' 

4 $TUXDIR/bin/tmunloadcf 

5 echo "\nexit $?" 
6 

7 #print -r "$prog" > prog 

8 rsh "$MASTER" -1 "$ADMIN" "$prog" | tee tiixconf. 

9 tmp • $ appname 

10 fi 

11 get_tlistenlog 

12 } 
13 

14 The subroutine "gettuxval" of this program (Page [28] of 

1^:: Appendix 2, lines 112 through 183) extracts parameters such as 

M LMID, APPDIR, TDXCONFIG, TDXDIR, ROOTDIR, ULOGPFX, NLSADDR, UID 

and BRIDGE from the binary configuration file of the application 

l^i obtained by means of the subroutine "get_tuxconf ig" . 

2^0 get_tuxval{) { 

2g gettuxconf ig ] \ 

m sed -e "s/=/ /g" -e '8/«//g' -e 's/\\\\/0/g' | awk ■ 

2l The values of the parameters sought are first initialized, 

is To do this, associative matrices called " txixconf ig_section" are 

26 created. 
27 

28 BEGIN { 

29 tuxconfig_section["*RESOURCES"] = 1 

30 tuxconfig_section["*MACHINES"] = 2 

31 tuxconfig_section["*GROUPS"] = 3 

32 tuxconfig_section["*SERVERS"] = 4 

33 tuxconfig_section["*SERVICES"] = 5 

34 tuxconfig_section["*ROUTING"] = 6 

35 tuxconfig_section["*NETWORK"] = 7 
36 

37 An index is associated with each matrix. The parameters 
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1 sought are located in different sections of the configuration 

2 file. For example, for the "Tuxedo" application, these different 

3 sections, which number seven, are called "Resources," "Machines," 

4 "Groups, "Servers," "Services," "Routing" and "Network." In order 

5 to be able to extract the parameters that the computer needs, it 

6 must be able to mark the place where it is found in the 

7 configuration file. In this program, when the field number (NF) 

8 is equal to 1, the computer is found at the beginning of a 

9 section. 
10 

11 NF 1 { 

1^ if { $1 in tuxconf ig_section ) { 

13; section = tuxconf ig_section [$1] 

3^ next 

M } 

m } 

m 

13 If the computer is in section 2 and the second word is LMID, 

iM the computer extracts the logical name of the machine (LMID) on 

2l£i which the administrator is working. 

2M section == 2 && $2 == "LMID { # MACHINES section 

23 if ( $3 == machine) { 

24 printf "uname=%s\n" , $1 

2 5 mach_f ound=l 

26 } 

27 else { # reset mach__found for further machines 

28 mach_found = 0 

29 } 

3 0 next 
31 } 

32 

33 If the computer is in section 2 and the first word is 

34 APPDIR, it extracts the access path to the directory under which 

35 the servers are bootstrapped. 



13 



1 

2 


section 


== 2 && $1 == "APPDIR" mach_found==l { 


3 




printf "appdir=%s\n", $2 


4 


appdir 


= $2 


5 


next 




6 
7 


} 




8 


Proceeding in the same way, the computer will successively 


9 


extract. 


in the machines section of the configuration file, the 


10 


absolute 


access path to the binary configuration file 


11 


(TUXCGNFIG) , the access path to the installation directory of the 


12 


Tuxedo software (TUXDIR or ROOTDIR) , information on the history 




of the application (ULOGPFX) , and in the network section, the 




address 


of the bridge of the machine (NLSADDR) . 


IS 


section 


== 2 && $1== "TUXCGNFIG" && mach_found == 1 { 






printf " ttixconf ig=%s\n" , $2 




next 






} 






section 


2 %% $1=="TUXDIR" && mach_found==l{ 






printf "tuxdir=%s\n", $2 




next 






} 






section 


== 2 $1== "ROOTDIR" mach_found==l { # for V4 






printf "t\ixdir=%s\n", $2 


26 


next 




27 


} 




28 


section 


= = 2 ScSc $1== "ULOGPFX" && mach_found==l { 


29 


ulogpfx=l; printf "ulogpf x=:%s\n" , $2 


30 


next 




31 


> 




32 


section 


== 7 && NF == 1 { 


33 


if { $1 == machine ) 


34 


{mach_found = 1} 


35 


else { # reset mach_found for other machines 


36 


mach 


found = 0 


37 


} 




38 


next 




39 


} 
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1 section == 7 && $1=="NLSADDR" && mach_£ound==l { 

2 printf "iilsaddr=%s\n" , $2 

3 next 

4 } 
5 

6 The program executes a loop in this sxibroutine for each 

7 machine until the computer finds the current machine. Then, the 

8 computer obtains, in the resources section of the configuration 

9 file, the identification of the user of the application (UID) • 
10 

11 section == 1 && $1 "UID" {printf "uid=%s\n", S2; next } 
12 

1^, If no value has been defined for the UID in the 

configuration file, the UID of the person who built the 

IM application is used. Next, the computer finds in the network 

3|| section of the configuration file the access path to the bridge 
(BRIDGE) of the machine. 

1^ 

lii section == 7 $1=="BRIDGE" && mach_f o\jnd==l { 

2lB The parameter ULOGPPX representing the history of the 

2M machine is an optional value. When it does not exist, the 

23 computer will generate a file called "ULOG" in the directory 

24 APPDIR containing information on the manipulations performed on 

25 the application. 
26 

27 if { ulogpfx == 0 ) { 

2 8 printf "ulogpfx=%s/ULOG\n" , appdir } 

29 } ' machines $machine appname=$appname 

30 lang="sed -e «s/=/ /g" -e "s/"/ /g" -e "s/;/ /" $ConfDir/ 

31 $appname.tux | awk • 

32 $1 == "LANG" {printf "lang=", $2}"" 

33 } 
34 
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1 In addition, the computer needs the working language of the 

2 application, represented by the parameter LANG, as well as the 

3 value "tlog". The parameter LANG is found in the user's 

4 configuration file. 
5 

6 lang="sed -e "s/=/ /g" -e "s/'//g" -e "s/;/ /" 

7 $ConfDir/$appname. tux | awk ■ 

8 $1 == "LANG" {printf "lang=", $2}'" 
9 

10 The value "tlog" refers to the file "tlistenlog . <name of 

11 the application> . <name of the machine>" containing the name of 

12 the history file of the listener module. 

lil In the subroutine get_tuxval, the program has gathered all 

l3C of the environment variables it needs to be able to start the 

1^^ process for assisting in the administration of a distributed 

llH application. This process makes it possible, in addition to 

13 starting and stopping one or more listener modules, to display 

1^ information on one or more listener modules, to change the log of 

ite one or more listener modules, to check the script of one or more 

2^ listener modules, and finally, to update the script of one or 

Tt more listener modules {Fig. 1) . 

22 The process for assisting in the administration of a 

23 distributed "Tuxedo" application is provided with a graphical 

24 interface that allows access to the commands of the transaction 

25 processing manager. To execute a task, the administrator is not 

26 required to enter commands; he need only click on icons to call 

27 up menus and indicate values via dialog boxes. The assisting 

28 process is controlled by menus, structured in tree form. The 

29 selection of an option in the main menu results in the display of 

30 the associated lower level menu. This process is repeated until a 
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1 pop-up dialog box is displayed, in which the administrator must 

2 enter parameter values. In order to be able to manage the 

3 listener modules of the distributed "Tuxedo" application, the 

4 administrator selects, from the main menu "Tuxedo Commands," the 

5 functions "Tuxedo Commands," "Start/Stop Tuxedo Configuration," 

6 "Set up a Tuxedo Application" and "Manage the Listener 

7 Processes." The selectable functions "Start Listener Processes," 

8 "Stop Listener Processes," "Change/Show Listener Process 

9 Parameters," "Show currently running Listener Processes," "Check 
10 consistency of Listener Process scripts with TUXCONFIG Level" and 
ICB "Update Listener Process to TUXCONFIG Level" appear in the window 
iSi of the graphical interface (Fig. 1) . To start listener modules, 
1% the administrator must select the command "Start Listener 

1^^ Processes" by positioning the cursor of his mouse on the box (11) 

1^: and pressing on the left button of his mouse. The window of Fig. 

1?^ 2 appears after the selection. If an application has been 

predesignated, its name is displayed in the box (21) • If not, the 

1M administrator is informed by the blinking marker of the cursor 

1^ that he must provide one. To do this, the administrator can 

20 either click on the "List" button (23) in order to display the 

21 list of the stored applications and select one of them, or 

22 explicitly enter the name of the desired application. Next, the 

23 administrator is informed by the blinking marker of the cursor in 

24 the box (22) that he must indicate the name(s) of the machine (s) 

25 in which a listener module must be started. In the same way, the 

26 list of the machines comprised in said application can be 

27 obtained by clicking on the "List" button (23) . In order to 

28 validate the machines selected, for example by being highlighted, 

29 the administrator must click on the "OK" button (24) . The command 
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1 for starting the listener module is obtained by selecting the 

2 "Command" button (25) . The "Reset" button (26) makes it possible 

3 to reset the values of the boxes (21) and (22) . The "?" button 

4 (28) offers online help to the administrator. 

5 For each machine designated in the list of machines, the 

6 computer obtains information on the application in the 

7 configuration file of the master machine, and a history file 

8 called "tlistenlog. <name of the application> • <name of the 

9 machine>" containing information on the application currently 
10 running on this machine. First, the computer checks to see 

Ig whether the listener laodule has already been started in the 

l^j machine. If this is the case, the message "Listener already 

itf running on <name of the machine>" is printed on the screen. 

^ Otherwise, if a local file exists, the computer executes it and 

1^ prints the message "Listener started on the machine" if the 

1^5 command succeeds. If the command fails, the computer prints the 

"W message "Listener starting failed on <name of the machine>". If 

1^ the local file does not exist, the computer generates a file 

rM "tlistenlog . <name of the application> . <ncune of the machine>" 

20 in the directory APPDIR, executes it, and reports the result as 

21 before. This file contains information on the current application 

22 and will be used in the next startup of the listener modules. 

23 This corresponds to lines 652 through 698 on page [36] and to 

24 lines 699 through 719 on page [37] of Appendix 2. 
25 

26 startlistproc) 

27 appname=$l; shift 

28 list="$*" 

29 set_environ 

30 loop_status=0 

31 exit status=0 



1 
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1 for machine in $list 

2 do 

3 echo "\n Machine: $machine \n" 

4 gettuxval > "appname. tux" 

5 get_tllog 

6 • • /appname • tux 

7 progl=" 

8 TUXDIR=$tuxdir; export TUXDIR 

9 ROOTDIR=$tuxdir; export ROOTDIR # V4 

10 APPDIR=$appdir; export APPDIR 

11 TUXCONFIG=$tuxconfig; export TUXCONFIG 

12 PATH=${PATH}:\$TUXDIR/bin:\SAPPDIR; export PATH 

13 LANG=$lang; export LANG 

14 LIBPATH=${LIBPATH}:$tuxdir/lib; export LIBPATH 

15 COLUMNS=200; export COLUMNS 

1|| ps -eP •%u %p %a» I awk'\$3 - |"tlisten\" \$0 - 
m \$nlsaddr\" {exit l}' 

m if [ \$? = 1 ] 

iP then 

2^^ echo \"Listener already running on $machine\" 

2j£ echo exit 0 

2l| exit 0 

# fi 

2^ if [ -f $appdir/tlisten.$appname.$machine ] 

2® then 

2^ • $appdir/tlisten. $appname$machine 

2^ ps -eF '%u %p% a' | awk '\$3 - \"listen\" && \$0 - 

2l \$nlsaddr\" {exit l}' 

2^ if [ \$? = 1 ] 

3 0 then 

31 echo \" Listener started on $machine\" 

32 echo exit 0 

33 else 

34 echo \"Listener starting failed on $machine ! ! ! \ " 

35 echo exit 1 

36 fi 

37 else # create the script file & exec it 

3 8 echo \"$tuxdir/bin/tlisten -d $bridge -1 $nlsaddr -u $uid 

39 -L $tllog\" > $appdir/tlisten,$appname.$machine 

40 chmod ug+x $appdir/tlisten,$appname.$machine 

41 • $appdir/tlisten. $ appname. $machine 

42 ps -eF '%u %p %a'|awk«\$3 - \"tlisten\" && \$0 - 

43 \"nlsaddr\" {exit l}' 
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1 if [ \$? = 1 ] 

2 then 

3 echo \"Listener started on $machine\" 

4 echo exit 0 

5 else 

6 echo \"Listener starting failed on $machine ! ! ! \ " 

7 echo exit 1 

8 fi 

9 fi" 

10 #echo "$progl" > progl 

11 i f [ - 2 $unaiae " ] 

12 then 

13 [print "Host $machine not found" 

14 exit 1 

15 fi 

Ig rsh $uname" -1 $ADMIN" "$progl" | awk " 

1^ NR == 1 {line = $0} 

iMI NR > 1 ( print line; line = $0 } 

iP END {if {sub{"^exit","«, line)) exit line; print line; 

M exit -1}" 

loop_status=^expr $loop_status\ | $?^ 

^ done 

^ exit $loop _status 

m 
m 

2%^ To Stop a listener module, the administrator selects, from 

2ff the main menu for managing listener modules, "Manage the Listener 

28 Processes", the function "Stop Listener Processes" by positioning 

29 his curser on the box (12) (Fig. 1) . The window of Fig* 3 

30 appears. It makes it possible to indicate, in a first box (31), 

31 the name of the application, and in a second box (32) , the name 

32 of the machine or machines. By clicking on the "List" button 

33 (33), a list of the applications stored or a list of the machines 

34 related to each application can be obtained depending on the 

35 position of the blinking position marker (34) . For each machine 
3 6 of the application, the computer prints the name of the machine 
37 for which the listener module is stopped. This selection on the 
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1 screen via the graphical interface starts the program steps 

2 "stoplistproc" during which the program obtains information, in 

3 the station in which the stop procedure is initiated, using 

4 get__tuxval on the application contained in the configuration file 

5 of the master machine (Page [37] of Appendix 2, lines 720 through 

6 762). 
7 

8 stoplistproc) 

9 appname=$l; shift 

10 list="$*" 

11 s e t_envi r on 

12 loop_s ta tus = 0 
1^ exi t s t a tus = 0 

1^ for machine in $list 

m do 

iP echo "\n Machine: $machine \n" 

itf get_tuxval > "appname. tux" 

iMj . . /appname . tux 

ijglj progl=" 

2y COLUMNS=200: export COLUMNS 

2g ps -eF '%u %p %a»|awk '\$3 - \"tlisten\" $0 - 

m \"$nlsaddr\" {print \$2; exit 0} | read pid 

2g| if [ -n\"\$pid\" ] 

:M then 

2f kill -9 \$pid > /dev/null 

2W status=\$? 

27 if [ \$status -eq 0 ] 

28 then 

29 echo \" Process \$pid killed on $machine\" 

30 echo exit 1 

31 else 

32 echo \"Failed to stop listener on $machine!N\" 

33 echo exit 1 

34 fi 

35 else 

3 6 echo \"No Listener rxinning on $machine\" 

37 echo exit 1 

38 fi" 

39 if [ -z "$uname" ] 

40 then 
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1 print "Host $machine not found" 

2 exit 1 

3 fi 

4 rsh "$unaine" -1 "$ADMIN" "$progl" | awk ' 

5 NR == 1 {line = $0} 

6 NR > 1 { print line; line =: $0 } 

7 END {if {sub{"^exit","", line)) exit line; print line; 

8 exit -1}' 

9 loop_status=^expr $loop_status \|$?^ 

10 done 

1 1 exi t $ loop__s ta tus 
12 

13 

14 If a process called "tlisten" belonging to the current 

IS:; application is running on this machine, the computer kills it and 

iM prints the message "Process <process identifier (PID) > killed on 

itt <name of the machine>; otherwise it prints the message "Failed to 

stop listener on <name of the machine>". 
1^ Furthermore, this process for assisting in the 

2^ administration of an application makes it possible to display 

^ information related to a listener module. To do this from the 

main menu for managing listener modules "Manage the Listener 

2§ Processes," the administrator need only select the function 

24 "Change/Show Listener Processes Parameters" in the box (13) of 

25 the window presented in Fig. 1* The window of Fig. 4 appears. The 

26 administrator must indicate, in the box (41) , the name of the 

27 application, and in the box (42), a machine neime. As a result of 

28 this indication, the other boxes (43 through 46) of the window 
2 9 will show the values of parameters such as: 

30 - the identification of the administrator (UID) , 

31 - the complete address of the listener module, composed of 

32 the address of the machine and the number of the port it is using 

33 (NLSADDR) , 
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1 - the access path to the network/ 

2 - the full access path to the log file of the listener 

3 module (Listener Logf ile Full Path Name, LLFPN) . 

4 All of this information is extracted from the file TUXCONFIG 

5 of the master machine. This information cannot be changed by this 

6 command, with the exception of LLFPN. Appendix 2 presents, on 

7 lines 570 through 579 on page [35] , the part of the program 

8 corresponding to the execution of the command for changing the 

9 LLFPN. 
10 

11 chglisten) 
1^ appname=$l 
1^: machine=$2 
iS shift 2 

if [ $# -gt 0 ] 
iffl then 

101 echo "TLLOG Smachine $1" > 

IM $ConfDir/tlistenlog/$ appname . $machine 

It 

2tf exit $? 

2S ; 
^ ; 

2%' In order to be able to display the active listener modules 

25 of the application, the administrator must select the function 

26 "Show currently running Listener Processes" by clicking on the 

27 box (14) of the window of Fig. 1. The computer displays the list 

28 of the machines of the application on which a listener module is 

29 active and the process identifier (PID) belonging to the 

30 configuration of the network. Appendix 2 presents, on lines 764 

31 through 768 on page [37] and on lines 769 through 809 of page 

32 [38] , the part of the program corresponding to the display of the 

33 list of active listener modules, which uses the function 
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1 get_tuxval . 
2 

3 running list) 

4 appname-$l 

5 loop_status-0 

6 s e t_envi r on 

7 list_lmids= "get_tuxconf ig | \ 

8 sed -e "s/«V/g" -e 's/"//g" -e s/\\\\/0/- -e s/\*//" | awk 

9 BEGIN { network=0 } 

10 {line = $0} 

11 NF == 1 {if (network == 1) print $1} 

12 $1 == "NETWORK" {network = 1} 

13 END {if {siib("^exit", "",line) ) exit line; exit -1 

14 for machine in $list_lmids 

15 do 

1^ gettuxval > "appname. tux" 

1^ . . /appname . tux 

3^ progl=" 

1^ TUXDIR=$tuxdir; export TUXDIR 

2m LIBPATH=${LIBPATH}:$tuxdir/lib; export LIBPATH 

2ffl ROOTDIR=$tuxdir; export ROOTDIR # V4 

2® APPDIR=$appdir; export APPDIR 

2^ TUXCONPIG=$tuxconfig; export TUXCONFIG 

2^ PATH=${PATH}:\$TUXDIR/bin:\$APPDIR; export PATH 

^ LANG=$lang; export LANG 

^ COLUMNS=200; export COLUMNS 

25 ps -eF '%u %p %a' | awk '\$3 - \"tlisten\" \$0 - 

|"$nlsaddr\" {print \$2}»| read pid 

29 if [ -n \"\$pid\" 3 

3 0 then 

31 echo \"Listener running on $machine: pid = \$pid\" 

32 echo exit 0 

33 else 

34 echo \"No Listener running on $machine\" 

35 echo exit 0 

36 fi" 

37 if [ -z $uname" ] 
3 8 then 

39 print "Host $machine not found" 

40 exit 1 

41 fi 

42 rsh "$uname" -1 "$ADMIN" "Sprogl" | awk ■ 



24 

1 NR == 1 {line = $0} 

2 NR > 1 { print line; line = $0 } 

3 END { if (s\ab{"^exit«,"", line)) exit line; print line; 

4 exit -1}' 

5 loop_status=^expr $loop_status\ | $?^ 

6 done 

7 exit $loop__status 

8 ;; 
9 

10 The administrator can also check the script of a listener 

11 module. By selecting the function "Check consistency of Listener 

12 Process scripts with Tuxconfig" in the box (15) of the window 

13 represented in Fig. 1, the window of Fig. 5 appears. The 

IW; administrator must enter the name of an application in the box 

iSl (51) and the name of a given machine in the box (52) . A list of 

Ig; the applications and the machines is made available to the 

ij^ administrator by the "List" button (53) . The program compares the 

1® information contained in the file TUXCONFIG of the master machine 

111 and extracted by the function "get_tuxval" with the information 

2JS1 contained in the file "tlisten. (name of the application) . (name of 

2S the machine) " located in the directory APPDIR of the machine and 
gives the result of this comparison. Appendix 2 presents, on 

23 lines 580 through 631 of page [35] and on lines 632 through 651 

24 of page [36] , the part of the program corresponding to the 

25 checking of a script of a listener module, which makes it 

26 possible to indicate the mismatches between the parameters of the 

27 files, for example by printing "BRIDGE values mismatch" for the 
2 8 bridge . 

29 

30 chklistscript) 

3 1 appname= $ 1 

32 machine=$2 

33 set environ 
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1 get_ttixval > " appname . tux" 

2 get_tllog 

3 . . / appname . tux 

4 prog= " 

5 if [ -£ $appdir/tlisten. $appnaxae. $machine ] 

6 then 

7 cat $appdir/tlisten.$appname.Smachine 

8 echo \"\\nexit 0\" 

9 else 

10 echo \"\\nexit 1\" 

11 fi" 

12 if [ -z "$uname" ] 

13 then 

14 print "Host $machine not found" 

15 exit 1 

Ify fi 

12 rm -f tlscript.$appname$machine 

lill rsh $uname" -1 "$ADMIN" "$prog" | tee tlscript. 
l9 $appncime. $machine > /dev/null 

29 [ $? -ne 0 ] exit 1 

2^ [ -s tlscript. $appname.$niachine ] cat tlscript. 
2% $appname . $machine | \awk ■ 

2j END {if { $2 == "1" ) exit -l}' 

2^ [ $? -eq -1 ] exit 1 

2il [ -s tlscript . $appna3ne. $machine ] && cat tlscript. 

2y $ appname . $machine | \ 

2© awk ' 

2W $1 - "tlisten" { 

2%' mismatch = 0 

3 0 fexec=sprintf {"%s/bin/tlisten", tuxdir) 

31 if ($1 !=fexec){ 

32 print "tlisten command full pathnames mismatch" 

33 printf "\tscript : \t%s\n" , $1 

34 printf "\tconf ig: \t%s\n" , fexec 

35 mismatch +=1 

36 } 

37 for (i=2; i <= NF; i++) { 

38 if {{$i == "-d") (S(i+1) != bridge) ) { 

39 print "BRIDGE values mismatch" 

40 printf "\tscript : \t%s\n" , $ (i+1) 

41 printf "\tconf ig: \t%s\n" , bridge 

42 mismatch +-1 

43 } 



26 



1 if {( $i == "-l") && {$(1+1) I =iilsaddr) ) { 

2 print "NLSADDR values mismatch" 

3 printf "\tscript : \t%s\n" , $(i+l) 

4 printf "\tconf ig: \t%s\n" , nlsaddr 

5 mismatch +=1 

6 } 

7 if (($i "-U") && ($(i+l) != uid)){ 

8 print "UID values mismatch" 

9 printf "\tscript:\t%s\n", $(i+l) 

10 printf "\tconf ig:\t%s\n", tllog 

11 mismatch +=1 

12 } 

13 }} 

14 END { 

15 if ( mismatch 0 ) 

Igl printf "Script File is up-to-date for %s\n", 

1^ machine 

lISl else 

l9 print f"\nScript File is NOT up-to-date for 

25i; %s\n", machine 

2;:^ } ' tllog=$tllog machine=$machine bridge=$bridge \ 

2pJ nlsaddr=$nlsaddr uid tuxdir=$tuxdir 

2 J exit S? 

m 

2^ 

2g: A script of a listener module can also be updated by 

2% selecting the fxinction "Update Listener Process scripts to 

28 TUXCONFIG Level." A script of a Tuxedo listener module makes it 

29 possible to start a listener module. It suffices to integrate a 

30 script of this type into the startup sequence for a given machine 

31 in order for the listening machine to be started automatically at 

32 the same time as the machine. In the window represented in Fig. 

33 6, the administrator enters in the box (61) the name of an 

34 application, and in the box (62) the name of one or more 

35 machines. The program, by calling the s\ibroutine "get tuxval" , 

36 obtains all of the information it needs in the binary 

37 configuration file extracted by the subroutine "get_tuxconf ig" 
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1 and creates a file corresponding to it in the directory APPDIR 

2 under the name "tlisten. (name of the application) • (name of the 

3 machine) . Lines 810 through 831 of Appendix 2, page [38] present 

4 the part of the program corresponding to the execution of the 

5 command for updating a script of a listener module. 
6 

7 updtlistscript) 

8 appneLme=$l 

9 machines $2 

10 s e t_envi r on 

11 get_tllog 

12 ge t_ tuxva 1 > " appname • tux " 

13 . . / appname . tux 
r^; prog=" 

iM echo \"$tuxdir/bin/tlisten -d $bridge -1 $nlsaddr -u $uid -L 

Ip $tllog\" > $appdir /t list en. $ appname .Smachine 

1^ chmod ug+x $appdir/tlisten. Sappname. $machine 

im echo exit \$?" 

lUl if [ - z " $uname " ] 

2® then 

23. print "Host $machine not found" 

2^ rsh "$uname" -1 "$ADMIN" "$prog" | awk ' 

2J NR == 1 {line = $0} 

21 NR > 1 { print line; line = $0 } 

27 END {if (sub("^exit","",line) ) exit line; print line; exit 

28 -1}" 

29 exit $? 
30 

31 

32 Other modifications within the capability of one skilled in 



the art are also part of the spirit of the invention. 
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Tuxedo configuration UBBCONFIG for the model TESTl 



'RESOURCES 

I PC KEY 

MASTER 

DO>IAIMID 

MAXACCESSERS 

MAX SERVERS 

MA.XSERVICES 

OPTIONS 

MODEL 

'I-L^.CHINES 
puce 



trif ide 



orage 



doml 



50 



191785 
sitel 



50 
100 
LAN 
MP 



LMID=sitel 

TUXDIR= "usr/ tuxedo " 

APPDI R= " /home/ di a / tuxedo " 

TUXC OWFIG="/ home/ di a /tuxedo /TUXCONFIG" 

ENVFILE= " /home/dia/ tuxedo/envf ile_puce" 

ULOGPFX= / home / di a / tuxedo /ULOG " 

LMID=site2 

TUXDI R= " u s r / tuxedo " 

APPDIR=" /home/dia /tmp" 

TUXCONFIG=" /home/dia/ tmp/TUXCONFIG" 

ENVFILE= "/home/dia/tmp/envf il€_trif ide" 

ULOGPFX= " / home / di a / tmp / ULOG " 

LMID=site3 

TUXDI R= " u s r / tuxedo " 

APPDIR= /home/dia/ tuxedo" 

TUXCONFIG=" /home/dia/ tuxedo/TUXCONFIG" 

ENVFILE= " / home / d i a / tuxedo / env f i 1 e_2 i g " 

ULOGPFX= " /home / di a / tuxedo / ULOG " 

LMID=site4 

TUXDI R= " u sr / tuxedo » 

AP PDI R= " / home / di a / tuxedo " 

TUXCONFIG= " /home/dia/ tuxedo /TUXCONF I G " 

ENVFILE= " / home / di a / tuxedo / env f i leverage " 

ULOGPFX= " /home/dia/ tuxedo/ULOG" 



TMSNAME=TMS 

LMID=sitel 

GRPN0=1 

LMID=site2 

GRPN0=2 

LMID=site3 

GRPN0=3 

LMID==site4 

GRPN0=4 



'GROUPS 

DEFAULT: TMSNAME=TMS TMSC0UNT=^2 

GROUPl 

GR0UP2 

GR0UP4 

GROUPS 

* SERVERS 
t 

DEFAULT: RESTART=Y MAXGEN=5 REPLYQ=Y CLOPT="-A" 
SRVl 

SRVGRP=GR0UP1 
SRVID=100 
MIN=2 MAX=2 
RQADDR:=QSRV1„1 
REPLYQ=Y 

CLOPT="-s SVC1_1 -s SVC1_2 " 



SRV2 



SRVGRP=GR0UP2 
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73 

74 

75 

76 

77 

78 

7S 

80 

61 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

111 

112 

113 

114 

115 

116 

117 

118 

119 

120 

121 

122 

123 

124 

125 

12 6 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 



SRV4 



SRV3 



* SERVICES 

DEFAULT: 

SVC 1_1 

SVC1„2 

SVC2_1 

SVC2_2 

SVC4_1 

SVC4_2 

SVC 3_1 



SRVID=200 
MIN=2 KAX=2 
R0ADDR=QSRV2_2 
REPLYQ^y 

CLOPT="-s SVC2_1 -s SVC2_2 

SRVGRP=:GR0UP4 
SRVID=300 
MIN=2 MAX=2 
RQADDR=QSRV4_3 
REPLyQ=Y 

CLOPT="-s SVC4_1 -s SVC4_2 — 

SRVGRP=GR0UP3 
SRVID=400 
MIN^2 MAX=2 
R0ADDR=QSRV3_4 
REPLYO=y 

CLOPT="-s SVC3_1 " 



LOAD=50 



* NETWORK 
sitel 



# 

site2 

# 

t 



site3 



site4 



port number=60951 (eel7 hexa) 
local address=81b683e0 
NADDR="\\x00O2eel781b683e0O0000000OOOOO000" 
BRIDGE^ " /dev/xti/ top" 
port number=60952 (eel8 hexa) 

NLSADDR= •'\\x0002eel88lb683e00000000000000000" 



port nuinber=60951 (eel 7 hexa) 
local address=8lb68387 

NADDR= "\\x0002eel78lb683870000000000000000" 

BRIDGE=Vdev/xti/tcp" 

port number=60952 {eel8 hexa) 

NLSADDR="\\x0002eel881b683870000000000000000" 



port nuinber=60951 (eel7 hexa) 
local address=81b683el 

NADDR= "\\x0002eel781b683el0000000000000000" 

BRIDGE^ •* /dev/xti / tcp** 

port nuinber==609S2 (eel8 hexa) 

NLSADDR="\\x00O2eel881b683el00OOOO00O000000O" 



port nuinbers6095l (eel7 hexa) 
local address=Slb6838b 

NADDR=»'\\x0002eel78lb6838b0000000000000000» 

BRIDGE== " / dev/xti/ tcp " 

port nuinber=60952 (eel8 hexa) 

NLSADDR="\\xO002eel881b6838b0OO0000O00000OOO'" 



1 

2 # @BULL_COPYRIGHT@ 

3 # 

4 # HISTORY 

5 # $Log: smtuxadmin. ksh, v $ 

6 # Revision 1.7 1996/02/12 11:40:49 odeadm 

7 # bci VlSet2C 23.01,96 

8 # [1996/01/23 14:31:07 dia] 

9 # 

10 # Revision 1.6 1995/12/20 14:26:59 odeadm 

11 # VI Set2: Still troubles with smtuxadmin. ksh 

12 # [1995/12/11 11:56:55 odeadm] 

13 # 

14 # 07.12.95 VlSet2 first batch of corrections 

15 # [1995/12/07 17:22:57 odeadm] 

16 # 

17 # *** empty log message *** 

18 # [1995/11/30 13:48:30 dxa] 

19 # 

20 # *** empty log message *** 

21 # [1995/11/30 13:48:30 dia] 

22 # 

23 # Revision 1.5 1995/10/13 11:52:51 odeadm 

24 # Servers TMS /Partitioned mach. 
2=5 # [1995/10/09 12:05:57 dia] 
^€ # 

^11 # Revision 1.4 1995/09/15 15:15:06 odeadm 

|2:8 # Corrections MRs BUILD 3 

2^ # [1995/09/07 15:45:27 dia] 

i$ # 

^ # Revision 1.3 1995/08/24 13:38:03 odeadm 

m # Build3 

S # [1995/08/23 09:04:31 odeadm] 

aj # 

ISS # Revision 1.2 1995/07/19 15:18:13 odeadm 

^6 # Madison build MO. 2 

^7 # [1995/07/10 10:01:58 odeadm] 

» # 

-Si # $EndLog$ 

m #! /bin/ ksh 

'M C onf D i r = $ WRAP P I NG_C ONF I GURAT I ON 

'^f Context^smtuxedo. ctx 

^3 Scanconf=$MADISON_VAR/surveyor/scanconf . tux 

€1 VS_to_V4='ROOTDIR^$TUXDIR; export ROOTDIR' 

45 Setl_to_Set2=' [ -2 "$ADMIN" ] && export ADMIN="madi son" 

4 6 cmd==$l; shift 

47 

4 8 set^environ ( ) { 

4 9 MASTER^""; APPDIR=""/ ADMIN="" 

filename=$ConfDir/$appname. tux 

51 Env=' tuxgetenv -k -v APP_PW $filename « ! 

52 tuxgetenvp 

53 ! ^ 

eval "$Env"; unset APP_PW 
eval "$Setl_to_Set2" 

if [ -n "$MASTER" -a -n "$APPDIR" ] 
^7 then 

Env="$Env 

5 9 $pw 

^0 $Setl_to_Set2 

61 $V5_to_V4"' 

^2 LD_LIBRARY_PATH-$LIBPATH; export LD LIBRARY PATH; 

€3 cd $APPDIR ~ ~ 

PATH=${PATH} : . :$APPDIR:$TUXDIR/bin; export PATH' 
return 0 
66 fi 

^"^ exit 1 

68 } 



64 
65 



69 
70 



remote cmd { ) { 



"^^ prog="$Env 



3/ 



72 $cind"' 

73 status==$? 

74 sleep 1 

75 echo "\nexit $status" 
76 

77, #print -r "$prog" > prog 

78 ' rsh "$MASTER" -1 "$ADMIN" "$prog" | awk ' 

79 NR == 1 {line - $0) 

8 0 NR > 1 { print line; line = $0} 

81 END {if (sub (""exit line)) exit line; exit -1 

82 } 
83 

84 

85 get_tuxconf ig ( ) { 

86 if [ -s tuxconf . tmp. ^appname 3 

87 then 

8 8 cat tuxconf . tmp . $ appname 

89 else 

SO rm -f tuxconf . tmp. * 

91 prog="$Env"' 

92 $TUXDIR/bin/tmunloadcf 

93 echo "\nexit $?" 
94 

95 #print -r "$prog" > prog 

M ^sh "^MASTER" -1 "$ADMIN" "$prog" | tee tuxconf . tmp .$ appname 

^ fi 

ijB get_tlistenlog 

m ] 

^i^l get_tlistenlog ( ) { 

Q2D 2 1 1 1 ogf name=$ C onf Di r / 1 1 i s t enl o g . $ appname . $ma chine 

fW3 if [ -s $tllogfname ] 

= then 

'ip5 cat $tllogfname 

11.0 6 else # default value 

^07 echo "TLLOG $machine $MADISON TMP/tlisten. $aDpname . $machine . log" I tee Stllocfname 

M)Q fi 

^09 echo "\nexit $?" 

QjLO } 

342 get_tuxval { ) { 

^5-3 get_tuxconfig 1 \ 

sed -e "s/=/ /g" -e 's/"//g' -e 's/\\\\/0/g' | awk ' 

iMS BEGIN { 

lie tuxconfig_section["*RESOURCES"] = 1 

117 tuxconfig_section["*MACHINES"3 ^ 2 

118 tuxconf ig^secti onf" *GROUPS"] = 3 

119 tuxconf ig_section["*SERVERS" 3 = 4 

120 tuxconf ig_section["*SERVICES"] = 5 

12 tuxconf ig_secti on [ "^ROUTING" 3 - 6 

122 tuxconf ig section [ "*NETWORK" 3 = 7 

123 ) 

124 NF =- 1 { 

125 if ( $1 in tuxconf ig_sect ion ) { 

126 section = tuxconf ig_section[$l3 

127 next 

128 } 

129 } 

130 section == 2 && $2 == "LMID" { # MACHINES section 

131 if ( 53 machine) { 

132 prmtf "uname-%s\n" , $1 

133 mach found=l 
134- } 

13 5 else ( # reset mach__found for furtheur machines 
13 6 mach found = 0 

137 ) 

138 next 

139 ) 

140 section 2 && $1=-"APPDIR" && mach_f ound=-l { 
1^1 printf "appdir=%s\n", $2 

142 appdir = $2 



209 
210 
211 
212 



52- 



143 next 

144 } 

145 section === 2 && $1=="TUXC0NFIG" && mach_found == 1 { 

14 6 printf " tuxconf ig=%s\n" , $2 

147 next 

148 } 

14^9- section == 2 && $1=="TUXDIR" && inach_f ound"l { 

150 prxntf " tuxdir=%s\n" , $2 

151 next 

152 } 

153 section 2 && $1""ROOTDIR" inach_f ound==l { # for V4 

154 printf "tuxdir=%s\n" , $2 

155 next 

156 ) 

157 section ~ 2 && $1=="UL0GPFX" && mach_f ound=l { 

15 8 ulogpfx=l; printf "ulogpf x=%s\n" , $2 
15 9 next 

160 } 

161 section == 7 && NF == 1 { 

162 if { $1 machine ) 

163 {mach_fo\md - 1) 

164 else { # reset mach_found for other machines 

165 mach_found - 0 

166 } 

167 next 
©8 } 

J69 section == 7 && 5 1=="NLSADDR" && mach_f ound==l { 
-110 printf "nlsaddr=%s\n", $2 

¥fl next 
§52 } 

rf3 section == 1 && $1 == "UID" {printf "uid=%s\n", $2 ;next } 
S74 section 7 && $1~"BRIDGE" && mach_f otind==l { 
Hf5 printf "bridge=%s\n", $2 } 

¥7 6 END { # not defined ulogpfx 
£|7 if ( ulogpfx == 0 ) { 

178 printf "ulogpf x=%s/ULOG\n" , appdir } 

1-7^ } ' ma chine=$ma chine appname=$appname 

^BQ lang='5ed -e "s/=/ /g" -e "s/V/g" -e "s/;/ /" $Conf Dir/$appname . tux 1 awk ' 

ill $1 "LANG" {printf "lang=", $2}' ^ 

I§2 } 
W3 

04 get_tllog() { 

■MS tllogfname="$ConfDir/tlistenlog. $appname.$machine" 
.I|6 if [ -f $tllogfname ] 
Ml then 

188 tllog=^cat $ tllogf name ! awk '$1 == "TLLOG" && $2 == machine { print $3 }' machine=$m 
achine' 

189 else 

190 tllog="$MM)ISON_TMP/tlistenlog.$appname.$machine" 

191 echo "TLLOG $machine $tllog" > $tllogfname 

192 fi 

193 } 
194 
195 

196 case $cmd m 

197 appli) 

Is -1 $ConfDir 2> /dev/null | awk ' 

sub(".tux$", $NF) {print $NF)''' 

201 
202 
203 
204 



205 else 
206 

207 fi 
208 



isexist ) 

if [ -f $ConfDir/$l.tux ] 
then 

echo "Yes" 



echo "No" 



setparam) 

I ! -d $ConfDir ] && mkdir -p $ConfDir 

if [ -n "$2" ] 

then 



213 f ilename=$Conf Dir/$2 . tux 

214 while [ $# -gt 0 ] 

215 do 

216 echo "$l-\"$2\"; export $1" 

217 shift 2 

218 done > $filename 

219 fi 
220 

221 discover) 

222 [ -2 "51" ] && exit 1 

223 f i 1 ename= $ Conf Di r / $ 1 . tux ; shift 

224 if [ -f ^filename ] 

225 then 

226 # sed -e ' s/ : /@(a(a/g ' -e 's/#.*//' -e 's/ *; */'Vg' 5filename/ i 
awk ' 

227 sed -e 's/#,*//' -e 's/ *; */"/g' -e •s/:/#i:/g' $filenaine/ 
I awk ' 

22 8 BEGIN { field = " #promptW: promptP : promptPO : prompts : promptA: pr 

cinptM:promptC:proinptR:promptF"; value=" ::::::::" ) 

229 /\-/ { 

230 for (i=l; i<= NF; i++) { 

231 if{sub("=$", $i)) { 

232 separator = " 

233 field field separator $i 
Zd'^ value = value separator 3 (i+l) 
^5 } 

£i6 } 
=237 } 
:#8 END { 

print field; print value 
Si5 0 } ' FS**' " ' 

Slei else 
Kl2 print '^Vn' 

1^3 fi 
IP4 ;; 
_^45 delappname) 
2.4 6 if [ -n "$2" ] 

^1 then 

H|6 filename-$ConfDir/$2 . tux 

if [ -f $filename ] && grep -q "$1= [ ' \"3 *$2" ^filename 
S 0 then 

rin -f $filename ${filename)p 

#2 else 

Jf^ echo 'The file does not exist' 

'^'^4 echo • or* 

echo 'The file is not an environment file* 

256 exit 1 

257 fi 

258 fi 
259 

260 select) 

261 if [ -n "$2" ] 

262 then 

l^^ echo "$1=='$2»; export $1" > "$Context" 

264 fi 

265 

266 deselect) 

2^"? rm -f "$Context" 

2 68 

269 selected} 

27 0 APPNAME="" 

lit [ $Context 3 && . . /$Context 

echo "$1$APPNAME" 

2"74 xsselected 



■P^ riti -f tuxconf . trap. * 

zl^ I $Context ] && fgrep -q "APPNAME=-" $Context && shift 



echo $1 
appnaine=$l 



278 

2*79 loadcf) 




loof 

281 ^boucle_status=0 

282 * cmd="\$TUXDIR/bin/tnaoadcf -y $2 $3" 
28 3 set_environ 

2 84 echo " Loading Configuration Binary File " 

2 85 r emot e_cmd 

2 8,6 status=$? 

287' if [ 3status -ne 0 ] 

28 8 then 

289 exit $status 

290 else 

291 # maj fichier $Scanconf . tux machines 

292 prog="$Env"* 
2 93 $TUXDIR/bin/tmunloadcf 
294 echo "\nexit $?" 
295 

296 #print -r "$prog" > prog 

297 rsh "$M?VSTER" -1 "$ADMIN" "$prog" > tuxconf . tmp . $appnaine 

298 list_lmids=' cat tuxconf . tmp . $appname | sed -e "s/=/ /g" -e 's/"//g' -e "s/\*// 
! awk ' 

299 {line = $0) 

300 $2 == *'LMID" && machine == 1 {Imids = Imids $3 " *' ; next} 

301 $1 "GROUPS" && $2 == { machine=0; next} 

302 $1 "MACHINES" && $2 == { machine = 1; next} 

303 END {if (sub("'^exit ","", line)) { 
^3:04 print Imids 
^<)5 exit line) 
#36 exit -1 } » ' 
|3;p7 for machine in $list_lmids 

Spe do 

^09 echo " Updating $Scanconf on $machine \n" 

4aU0 get_tuxval > " appname . tux" 

[ill . ./ appname . tux 

= i;12 log_pref ix'^* echo $ulogpfx | sed -e 's,/. ,g' I awk ' 

gl3 {print $NF} ' ^ 

^^4 log_dir=^' echo $ulogpfx | sed -e 's./. ,g' ! awk * 

=315 {for (i=l; i< NF; i++) { 

fSA6 tempo = tempo $i }} 

Si 7 END { print tempo) ' ' 

iJlS #Build the 3 lines of $Scanconf for the application 

LiP-9 prog=" 

p;20 [ -X $MADISON_BIN/security/updscantux ] && 

^21 $MADISON_BIN/security/updscantux $appname $log dir $log_prefix 
^2 echo \"\\nexit \$?\"" 

'il23 rsh "$uname" -1 madison "$prog" | awk ' 

■^24 NR -= 1 {line = $0} 

325 NR > 1 { print line; line = $0} 

326 END {if (s\ib("-exit ","", line)) exit line; exit -1 }' 

327 boucle _status=^ expr $boucle status + $? ' 

328 done ' ~ 

329 fi 

330 exit $boucle status 

331 — rr^~ 

332 apppwd) 

333 f ilename==$ConfDir/$l . tuxp 

334 echo "Enter Application Password: \c" 

335 OLDCONFIG^* stty -g' 

336 stty -echo 

337 read APP_PW 

338 echo "\nRe-enter Application Password: \c" 

339 read APP_PW_1 
3^0 stty $OLDCONFIG 

341 if [ "$APP PW" != "$APP PW 1" ] 

342 then ~ " ~ 
■^^3 echo "\n\nPassword mismatch!" 

■^^^ echo "Enter any character to exit and retry" 

345 read 

346 else 

^^"^ # PWencode "APP_PW=\"$APP_PW\" ; export APP_PW" > $filename 

-^^^ # APP_PW=^echo $APP_PW i sed -e "s/ ' / ' \" ' \" ' /g" ^ 

# PWencode "APP_PW= ' $APP_PW' ; export APP_PW" > $filename 

35 0 tuxgetenv -s > ^filename « 1 



351 tuxgetenvp 

352 $APP_PW 

353 I 

354 fi 
355 

35^6 chksyntx) 

357" appnaine=$l 

358 cmd'^"\$TUXDIR/bin/"t:mloadcf -n $2" 

35 9 set_environ 

3 60 r emo t e_cmd 

361 exit $? 

362 

363 displpc) 

3 64 appname=$l 

365 cmd="\$TUXDIR/bin/tmloadcf -c $2" 

366 set_environ 
3 67 reinote_cind 
368 exit $? 

369 

370 mach3.ne_network) 

371 appname=$l 

372 set_environ 

373 get_tuxconf ig i \ 

374 sed -e "s/=/ /g" -e 's/"//g' -e 's/\\//' -e "s/\*//" | awk 
3J5 BEGIN { network=0 } 

^6 {line = $0} 

#77 NF == 1 { if (network == 1} print $1) 

^308 $1 == "NETWORK" { network = 1} 

S79 END {if (sub {"-exit line)) exit line; exit -1 )' 

^80 exit $? 

ijBl ;; 

1^83 ma chin e_ma chines) 

^ appnaine=^$ 1 

id^5 set_environ 

=38 6 get_tuxconf ig \ \ 

-:=3;37 sed -e "s/=/ /g" -e 's/"//g' -e 's/\\//' -e "s/\*//" | awk 

BEGIN { machine=0 } 

{line = $0} 

= 390 $2 
291 
W92 
^193 

exi 



411 



417 
418 



420 




} ' 



■395 

3 96 group) 

397 appnaiue=$l 

398 set_environ 

399 get_tuxconfig I \ 

sed -e •'s/=/ /g" -e 's/"//g' -e 's/\\//' -e "s/\*//" 1 awk 
^01 BEGIN { group=0 } 

^02 {line = $0} 

^^03 $1 == "SERVERS" { group=0 } 

$1 "GROUPS" { if ($2 "") group-1} 

$2 "LMID" && $4 == "GRPNO" { if (group) print $1} 

END {if (subl^-^exit line)) exit line; exit -1 }' 

^07 exxt $? 

408 

^05 svrname) 

appnaine=$l 



set environ 



get_tuxconf ig I \ 

sed -e "s/-/ /g" -e 's/"//g' -e 's/\\//' -e "s/\*//" 1 awk 
BEGIN { group=server=nb_of distinct svr name=0 ) 
{line - $0} ~ ~ 

$1 == "TMSNAME" { if ( group ~ 1) { 
trouve = 0 



if (nb_of_distinct__svr_naitie ==0) { 



^5;^ nb of distinct svr name=l 



print $2 



svr_naines [nb_of__distinct_svr_name] = $2 



474 
475 
476 
477 



480 
481 
482 
483 
484 



48e 
487 
488 
489 
490 
491 
492 



422 } else { 

423 for (j=l; j<= nb_of_distinct_svr_name; j++) { 
42 4 if ( $2 svr_names[j] ) { 

425 trouve=l 

426 } 

427 } 

42'^8" if (trouve ==0) { 

42 9 nb_of_distinct_svr_name += 1 

430 svr_naines [nb_of_distinct_svr_name] = $2 

431 print $2 

432 ) 

433 } 

434 } 

435 } 

436 $1 =- "SERVERS" { if ($2 == { 

437 server=l 

43 8 group=0 } 

439 ] 

440 $1 "SERVICES" { if {$2== "") server=0) 

441 $1 "GROUPS" { if ($2 " "") group^l} 

442 $2 "SRVGRP" { 

443 if ({server == 1) && ( $4 == "SRVID")) { 

44 4 trouve = 0 

4 45 if (nb_of_distinct_svr_naine ==0) { 

J,4 6 nb_of_distinct_svr_naine = 1 

K7 svr_naines [nb_of_distinct_svr_name] = $1 

=Ji4 8 print $1 

||;|4 9 } else { 

for{j=^l; j<= nb_of_distinct_svr_name; { 
3J51 if { $1 svr_names[j] ) { 

l|B2 trouve=l 
fgi53 } 

ISM } 

4:i55 if (trouve ==0) { 

yi5 6 nb_of_distinct_svr_name += 1 

=="^57 svr_names [nb_of_distinct_svr naiae] - $1 

f^58 print $1 

WS9 } 

^0 } 

14:61 } 

^2 ] 

END {if (siab("'^exit ","", line)} exit line; exit -1 }' 
^^4 exit $? 

J|65 ; ; 

T66 svrseq) 

appname=$l 
^^8 set_environ 

get_tuxconf ig 1 \ 

^■^0 sed -e "s/=/ /g" -e *s/"//g' -e 's/\\//' -e "s/\*//" I awk ' 

^"^1 BEGIN { server=0; nb_of distinct svr seq=0 ) 

{line - $0} " ~ ~ 

$1 == "SEQUENCE" && server == 1 { 
trouve - 0 

if {nb_of_dist2.nct_svr__seg 0) { 
nb_of_distinct__svr_seq-l 
svr_seqs Inb_of_distinct_svr seq] = $2 
^■^8 print $2 

479 ) else { 

for {j=l; j<= nb_of_distinct__svr_seq; { 
if { $2 == svr_seqs[j] ) { 
trouve=l 

) 

} 



if {trouve ==0) { 



nb_of__distinct_svr_seq += 1 

svr_seqs [nb_of_distinct_svr_seq3 = $2 

print $2 

} 

} 

) 

$1 "SERVERS" { if ($2 == server=l} 
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493 
494 
495 
496 
497 
498 
4 9^9- 
500 
501 
502 
503 
504 
505 
506 
507 
508 
509 
510 
511 
512 
513 
514 
515 
516 

iis 

^9 
s52 0 

SSi 

SyH3 
^24 

:S5 

B7 
32 8 
1,29 
^^0 

^a4 

=|B5 

^7 
538 
539 
540 
541 
542 
543 
544 
545 
546 
547 
548 
549 
550 
551 
552 
553 
554 
555 
556 
557 
558 
559 
560 
561 
562 
563 



$1 = "SERVICES" { if($2 == 5erver=0} 
END {if {sub (""exit line}) exit line; exit -1 }' 

exit $? 



svrld) 



V/g' -e 's/W//' -e "s/\*//' 
nb_of_distinct svr ld=0 ) 



server 1 { 



appname=$l 
set_environ 
get_tuxconf ig | \ 
sed -e "s/=/ /g" -e ' s/ 

BEGIN { server=0; _ _ 

{line = $0} 

$2 "SRVGRP" && $4 "SRVID 

trouve = 0 

if (nb_of_distinct_svr_Id ==0) { 
nb_o f _di s t inc t_s vr_I d= 1 
svr_Ids [nb_of_distinct_svr_Id] = $5 
print $5 

} else { 

for {j=l; j<= nb_of_distinct_svr_Id; { 
if ( $5 — svr_Ids [j] ) { 
trouve^l 



1 awk 



} 

if 



} 



{trouve 0) { 

nb_of_distinct_svr_Id += 1 

svr_Ids [nb_of_distinct__svr_Id3 = $5 

print $5 



$1 == 
$1 " 



"SERVERS" { if {$2 == 
"SERVICES" { if ($2 



END (if (sub (""exit 



exit 5? 

discover_conf ) 

machine=$2 
appname=$l 
set_environ 
get_tuxconf ig i \ 
sed -e "s/=/ /g" - 



line) ) 



server=l } 
server=0 } 
exit line; 



exit -1 ) 



BEGIN 
{line 
$1 ~ 



) 

$1 



^s/"//g' -e 's/\\\\/0/^ 



{field = 
- $0} 
"UID" { 

field = field separator $1 
value = value separator $2 
separator - " : " 

"GID" { 

field - field separator $1 
value = value separator $2 
separator = " : " 



$1 == "BRIDGE" && network 1 && mach_found 
field - field separator $1 
value = value separator $2 



's/\*//" i awk • 



1 { 



$1 — 



NLSADDR" && network =«=!&& mach_found 
field = field separator $1 
value - value separator $2 
network = 0 
mach found = 0 



1 = 



1 { 



TLLOG" && $2 == machine { 
field = field separator $1 
value value separator $3 



$1 machine {inach_found = 1) 
$1 ==== "NETWORK" { network = 1} 



3f 



5 64 END { 

5 65 print field; print value 

566 if {sub("'^exit line)) exit line; exit -1 

5 67 } ' "machine=$machine" 

568 exit $? 
5 69 

57'b' chglisten) 

571 appname=$l 

572 machine-$2 

573 shift 2 

574 if [ $# -gt 0 ] 

575 then 

576 echo "TLLOG $inachine $1" > $Ccnf Dir/tlistenlog . $appnanie . $machine 

577 fi 

578 exit $? 
579 

580 chklist script) 

581 appnaine=$l 

582 machine=$2 

5 83 set^environ 

584 get_tuxval > "appname . tux" 

585 get_tllog 

586 . . /appname. tux 
5 87 prog=" 

5.88 if [ -f $appdir/tlisten.$appname.$machine ] 

SI 9 then 

§?0 cat $appdir/tlisten, $appnaine. $niachine 

£§1 echo \"\\nexit 0\" 

Sf2 else 

ii3 echo \"\\nexit 1\" 

i|4 fi" 

^95 if [ -z "$unairie" ] 

S|6 then 

print "Host ^machine not foxind" 

||8 exit 1 

fi 

rm -f tlscript. $ appname. $ma chine 

^sh "$uname" -1 "$ADMIN" "$prog" | tee tls or ipt .$ appname . $machine > / 

[11 dev/null 

fh^ [ $? -ne 0 ] && exit 1 

f?-^ [ ~s tlscript .$ appname. $machine ] && cat tlscript appname . $ma chine I 

^ awk ' 

#4 END { if ( $2 == "1" ) exit -1} ' 

|f5 [ $? -eq -1 3 && exit 1 

[ -s tlscript. $appname.$machine ] && cat tlscript . 5 appname . $machine I 



S^66 



607 awk ' 

^08 $1 ^ "tlisten" { 

laismatch = 0 

fexec=sprintf {"%s/bin/tlisten", tuxdir) 
If {$1 != fexec) { 

print "tlisten command full pathnames mismatch" 
printf "\tscript: \t%s\n", $1 
%\\ printf "\tconfig:\t%s\n", fexec 

mismatch +=1 
} 

for (i=2; i <= NF; i++) { 



615 
616 
617 
618 



628 
629 
630 
631 



If {{ $i == "-d") && ($(i+l} != bridge)) { 



^3;^ print "BRIDGE values mismatch 



620 
621 
622 
623 
624 

print "NLSADDR values mismatch" 

627 



printf "\tscript: \t%s\n", $ (i+1) 
printf "\tconf ig: \t%s\n" , bridge 
mismatch 

} 

if ( ( $i -= "-1") && ($(i+l) I=nlsaddr)) { 



printf "\tscript:\t%s\n*', $ (i+l) 
printf "\tconf ig: \t%s\n" , nlsaddr 
mismatch +=1 
} 

if { ( $i — "-U") && ($(i+l) != uid) ) { 
print "UID values mismatch" 
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683 



£S8 
€89 
€90 
€91 



£94 
€95 
€9€ 

€97 
€98 



^bovxcie l oop ^ 



632 printf "\tscript : \t%s\n" , $(i+l) 

633 printf " \tconf ig: \t%s\n" , uid 

634 mismatch +=1 

635 } 

636 if { ( $i == "-L") && (${i+l) !=tllog)) { 

637 print "LOGFILE values mismatch" 
638' printf " \tscript : \t%s\n'\ $(i+l} 

639 printf " \tconf ig : \t%s\n" , tllog 

640 mismatch +-1 

641 } 

642 ) } 
€43 END { 

64 4 if { mismatch == 0 ) 

645 printf "Script File is up-to-date for %s\n" , machine 

646 else 

647 printf "\nScript File is NOT up-to-date for %s\n" , machine 
€4 8 } ' tllog=$tllog machine=$machine bridge=$bridge \ 
€4 9 nlsaddr=$nlsaddr uid=$uid tuxdir=$tuxdir 
650 exit $? 
€51 

€52 startlistproc) 

653 appname=$l; shift 

654 list="$*" 
€55 set_environ 

65 6 bcucle status^O 
^.1 exit_s'tatus=0 
§^,8 for machine in $list 
^9 do 

^0 echo "\n Machine: $ma chine \n" 

^61 get_tuxval > "appname . tux" 

^2 get_tllog 

^.63 . . /appname . tux 

fiA progl=" 

^65 TUXDIR'=$tuxdir; export TUXDIR 

gi6 R0OTDIR=$tuxdir; export ROOTDIR # V4 

§"^"7 APPDIR=$appdir; export APPDIR 

1,68 TUXCONFIG=$tuxconf ig; export TUXCONFIG 

PATH=${PATH} :\$TUXDIR/bin:\$APPDIR; export PATH 
61 0 LANG=$lang; export lANG 

Oil LIBPATH=${LIBPATH} :$tuxdir/lib; export LIBPATH 

£f2 COLXn<[NS=200; export COLUMNS 

^3 ps -eF •%u %p %a' | awk • \$3 \"tlisten\" && \$0 - \"$nlsaddr\" { 

ku exit 1} • 

if [ \$? = 1 ] 
^5 then 

echo \"Listener already running on $machine\" 
^'^'7 echo exit 0 

^"78 exit 0 

79 

if I -f $ appdir/tlis ten. $ appname. 5 ma chine ] 
^61 then 

. $appdir/tlisten. $ appname. $machine 
ps -eF '%u %p %a' i awk '\$3 - \"tlisten\" && \$0 - \"$nls 



addr\" {exit 1} ' 

if [ \$? = 1 ] 
^S5 then 

€86 



^^"^ echo exit 0 



echo \"Listener started on $machine\' 



else 

echo \"Listener starting failed on Smachine !!!\" 
echo exit 1 

fi 

else # create the script file & exec it 
'•^ , echo \"$tuxdir/bin/tlisten -d $bridge -1 $nlsaddr -u $uid -L 

StllogX" > $appdar/tlisten. $appname. ^machine 

chmod ug+x $ appdir/tlis ten. $ appname - $ma chine 
. $appdir/tlisten. $appname. ^machine 

ps -eF '%u %p %a' I awk ' \$3 - \"tlisten\" && \$0 - \"$nlsadd 

r\" {exit 1) ' 

if [ \$? = 1 ] 
then 



^0 



699 echo \"Listener started on $machine\" 

700 echo exit 0 

701 else 

702 echo \"Listener starting failed on $machine !!!\" 

703 echo exit 1 

704 fi 
70S- fi" 

706 #echo "$progl" > progl 

707 if [ -2 "$iiname" ] 

708 then 

7 09 P^int "Host $machine not found" 

710 exit 1 

711 fi 

712 rsh "$unaine" -1 "$ADMIN" "$progl" ! awk ' 

713 NR " 1 {line = $0) 

714 NR > 1 { print line; line = $0 } 

715 END {if (sub (""exit line)) exit line; print line; exit -1}' 

716 boucle_status=^ expr $ boucle status \| $? ^ 

717 cTone 

718 exit $ boucl e_status 

719 ;; * 

720 stoplistproc) 

721 appname=$l; shift 

722 list="$*" 

723 set_environ 
g|4 boucle status^O 
jf|5 exit_status-0 

for machine in $list 

l?:27 do 

i|6 echo "\n Machine: $ma chine \n" 

1^1 9 get_tuxval > " appname . tux " 

3? 0 . . / appname , tux 

Ml progl =" 

If? 2 COLUMNS=200; export COLUMNS 

f?3 ps -eF *%u %p %a' | awk ' \$3 - \"tlisten\" && \$0 - \"$nlsaddr\" {print \$ 

2; exit 0 } ' ! read pid 

?34 if [ -n \"\$pid\" ] 

El 5 then 

kill -9 \$pid > /dev/null 

737 status=^\$? 

if [ \$status -eq 0 ] 

©9' then 

echo \"Process \$pid killed on $machine\" 

"Si echo exit 0 

'MZ else 

"^^^ echo \"Failed to stop listener on ^machine ! ! ! \ " 

74 4 echo exit 1 

745 fi 

746 else 

"^4 7 echo \"No Listener running on $inachine\" 

748 echo exit 1 

749 fi" 

75 0 if [ -2 "$uname" ] 
751 then 

"^^2 print "Host ^machine not found" 

^53 exit 1 

754 fi 

'^^^ rsh "$unaine" -1 "$ADMIN" "$progl" i awk ' 

"^^^ NR == 1 {line - $0} 

V''^ NR > 1 { print line; line = $0 } 

SND {if (sub ("-exit line)} exit line; print line; exit -1)' 

boucle status^ >xpr $boucle status \i $? ^ 

done ' ^ 

"^^i exit $boucle status 

762 ;; 

763 

"^^4 runnmglist) 

"^^5 appname=$l 

7S6 boucle status^O 

"^^7 set_ehviron 

*^^8 list_lmids=^ get_tuxconf ig ! \ 



76S sed -e "s/=/ /g" -e *s/"//g' -e 's/\\\\/0/* -e "s/\*//" 1 awk ' 

770 BEGIN { network=0 ) 

771 {line $0} 

772 NF 1 { if (network 1) print $1} 

773 $1 == "NETWORK" { network = 1} 

774 END {if (sub (""exit line)) exit line; exit -1 ) ' ^ 
775* for machine m $list_lmids 

776 do 

777 get_tuxval > "appname . tux" 
77 8 . . /appname . tux 

779 progl=" 

780 TUXDIR=$tuxdir; export TUXDIR 

751 LIBPATH=${LIBPATH} :$tuxdir/lib; export LIBPATH 

752 ROOTDIR^$tuxdir; export ROOTDIR # V4 
783 APPDIR=$appdir; export APPDIR 

7S4 TUXCONFIG^$tuxconfig; export TXJXCONFIG 

785 PATK=${PATH) :\$TUXDIR/bin:\$APPDIR; export PATH 
7S6 XANG=$lang; export LANG 

787 COLUMNS=2 00; export COLUMNS 

786 ps -eF ' %u %p %a* | awk ' \$3 - \"tlisten\" && \$0 - \"$nlsaddr\" {print 
\$2) ' ! read pid 

789 if [ -n \"\$pid\" ] 

750 then 

791 echo \"Listener running on $machine: pid = \$pid\" 

792 echo exit 0 
®3 else 

ijf-^ echo \"No Listener running on $ma chine \" 

5T55 echo exit 0 

556 fi" 

Sl7 if [ -z "$unaine" ] 

gp8 then 

-??99 print "Host $machine not found" 

l&O exit 1 

'^bl fi 

1P2 rsh "$uname" -1 "$ADHIN" "$progl" ! awk ' 

Jb3 NR == 1 (line = $0} 

1;P^ NR > 1 { print line; line = $0} 

"^5^5 END { if (sub{"'^exit ", "", line)) exit line; print line; exit -1} ' 

boucl e status='expr $ boucle status \1 

=§p7 done ' • ' 

SpS exit $ boucl e status 

^-09 ;; * *~ 

©0 updtlistscript) 

■3% 1 appname— $ 1 

^'12 machine=$2 

813 set^environ 

ei4 get_tllog 

815 get_tuxval > "appname . tux" 

SI 6 . . /appname. tux 

817 prog=" 

echo \"$tuxdir/bin/tlisten -d ^bridge -1 $nlsaddr -u $uid -L $tllog\" > 5app 
cir /til St en, $ appname. $ma chine 

chmod ug+x $appdir/tlisten. $ appname . $machine 

82G echo exit \$?" 

821 If [ -2 "$uname" ] 

822 then 

8f3 print "Host $machine not found" 
exit 1 

f 1 

^26 rsh "$uname" -1 "$ADMIN" "$prog" 1 awk ' 

827 NR == 1 (line = SO} 

NR > 1 { print line; line = $0 } 

in END {if (sub ("'^exit ","", line)} exit line; print line; exit -1}' 

S-'wv exit $? 



819 



5 '> 



832 
c -5 - 

83- 
835 
836 
837 



ixBootEnt ) 

appname=$l; shift 

cmd="\$TUXDIR/bin/tmboot -y $@" 

set_environ 

remote_cmd 

exit $7 



903 
904 



838 

83 9 tuxShutEnt) 

84 0 appname=$l; shift 

841 cnid="\$TUXDIR/bin/t:mshu1:down -y" 

8 42 set^environ 

843 remote_cind 

8 44 exit $? 

845 

84 6 tuxBootAllMach) 

8 47 appname=$l; shift 

848 cmd="\$TUXDIR/bin/tinboot -y -A $@" 

84 9 set_environ 

850 remote_cmd 

851 exit $? 

852 

853 tuxShutAllMach) 

854 appname=$l; shift 

855 cmd="\$TUXDIR/bin/tmshutdown -y -A 

85 6 set_environ 

857 remote_cmd 

858 exit $? 
859 

8 60 tuxShut) 

8 61 appname=$l; shift 

8 62 cmd="\$TUXDIR/bin/tmshutdown -y $@" 

i|3 set_environ 

'844 remote_cmd 

ffi5 exit $? 

fele ; ; 

S|7 tuxShutAdmMast) 

gfS appnam€=$l; shift 

S|9 cmd="\$TUXDIR/bin/tmshutdown -y -M 

0 s e t_envi r on 

1 0 r emo t e_cmd 

$]72 exit $? 
F73 

%7 4 tuxShutSvrSect) 

©5 appnaine=$l; shift 

gf6 cmd="\$TUXDIR/bin/tmshutdown -y -S 

^7 "7 set__environ 

^-#8 r emo t e_cind 

1|9 exit $? 

iffO 

^■§|l tuxBootAdmMast) 

^2 appnaine=$l; shift 

883 cind="\$TUXDIR/bin/tinboot -y -M $8" 

88 4 set_environ 

8 85 remote^cmd 

886 exit ^? 

887 

888 tuxBoot) 

88 9 appnaTae=$l; shift 

890 cmd^"\$TUXDIR/bin/tmboot -y $0" 

8 91 set_environ 

8 92 r emo t e_cmd 

893 exit $? 

894 

8 95 tuxShutdown) 

896 appname=$2 

897 cmd="\$TUXDIR/bin/tmshutdown -y $1" 
8 98 set_environ 

8 99 remote cmd 

900 exit $? 
901 

?02 tuxBootSvrSct) 

appname = $ 1 ; shift 

cmd="\$TUXDIR/bin/tmboot -y -S $@" 



set environ 



906 
907 
908 



remote_cmd 

exit $? 



90 9 tuxBootBBL) 

910 #echo $* 

911 appnaine=$l; shift 

912 cmd="\$TUXDIR/bin/tinboot -y $@" 

913 set^environ 

914 remote_cmd 
gi'B- exit $? 
916 

917 tuxShowBooted) 

91 e appnaine=$l; shift 

919 cmd="(echo psr; echo quit ) | X^TUXDIR/bxn/tmadmin" 

920 set_environ 

921 remote__cind 

922 exit $? 
923 

92 4 tuxminlPC) 

92 5 appname^$l; shift 

926 cmd:^"\$TUXDIR/bin/tinboot -y -c 56" 

92 7 set^environ 

92 8 r emo t e_cmd 

929 exit $? 

930 

931 tuxShutPart) 

932 exit_status=0 

933 appname=$l; 

Ci34 machine=$2; shift 

set_environ 

336 get_tuxconf ig 1 \ 

#7 sed -e "s/=/ /g" -e 's/"//g^ -e 's/W//' -e "s/\*//" ! awk ' 
3|38 $1 == "APPDIR" && mach_section 1 && mach_fo\ind == 1 { 

ff^ print "APPDIR " $2 > " appnairie . tux " 

Wr^ mach_section = 0 

^^1 mach found = 0 

mi } ~ 

51 == "TUXCONFIG" inach_section"l && mach found=^l { 

"^^^^ print "TUXCONFIG " $2 > "appname . tux" 

S945 J 

®^ $1 == "MACHINES" {mach_section = 1} 

$2 == "LMID" && mach_section == 1 && $3 machine { 
^f^S print "MACHINE " $1 > "anpname . tux" 

mach found = 1 

SBO ] 

■^'^ ?1 === "TUXDIR" && mach_5ection==l && mach_f ound^==l { 

print "TUXDIR " $2 > " appname . tux " 

■^§63 } 

' "ma chine=$ina chine" " appname =$ appname" 
955 if [ $? != 0 3 

95 6 then 
557 exit 1 

958 fi 

appdir^^awk '$1 "APPDIR" {print $2}' appname . tux ^ 

tuxconfig=^awk '$1 "TUXCONFIG" {print $2}' appname. tux' 

uname^'awk '$1 == "MACHINE" {print $2}' appname* tux^ 

:P rootdir=^awk '$1 == "TUXDIR" {print $2}' appname, tux^ 

lang=^sed -e '5/=/ /g' -e 's/;/ /g' $Conf Dxr/$appname , tux 1 

awk '$1 == "LANG" {print $2}'^ 

progl^"TUXDIR=$rootdir; export TUXDIR 

APPDIR=$appdir; export APPDIR 

111 LIBPATH=${LIBPATH} :$rootdir/lib; export LIBPATH 

TUXCONFIG=$tuxconfig; export TUXCONFIG 

LANG=$lang; export LANG 

-^1^ PATH-${PATH} :\$TUXDIR/bin:\$APPDIR; export PATH 

$TUXDIR/bin/tmshutdown -y -P $@ 

echo \$? > /tmp/rem$apDname. $machine. tux" 

if [ -2 "$uname" ] 

^7^3 then 

print "Host $machine not found" 

XZ*^ exit 1 

977 fi 

rsh $uname -1 "$ADMIN" "$progl" 
rsh_status=' echo 



ANNEXE 2 



980 if [ "$rsh_5tatus" -eg "0" ] 

981 then 

982 status='rsh $uname -1 "$ADMIN" "cat /tinp/rein$appname . $ina chine . tux" ' 

983 _^ rsh ^MASTER -1 "$ADMIN" "rm /tmp/rem$appnaine .$ ma chine . tux" 2> /dev/nul 

984 rsh $unaine -1 "$ADMIN" "nti /tmp/rem$appname . $machine . tux" 2> /dev/nul 

' ' 1 

985 fi 

98 6 If [ "$status" -ne "0" ] 

987 then 

988 exit_status=* expr $exit_status + 1^ 

989 fi 

990 if [ "$exit_status" -ne "0" -o "$rsh_status" -ne "0" ] 

991 then 

992 exit 1 

993 fx 
994 

995 loadf shm) 

996 appname=$l; machine=$2; shift 2 

997 set_environ 

998 get_tuxval > "appname . tux" 

999 . . / appname . tux 

1000 prog=" 

1001 TUXDIR^$tuxdir; export TTODIR 

1002 ROOTDIR=$tuxdir; export ROOTDIR 

m03 LIBPATH=${LIBPATH} :$tuxdir/lib; export LIBPATH 

XD04 LANG==$lang; export LANG 

l^eoS $tuxdir/bin/loadfiles $@ 

feioe echo \"\nexit \$?\"" 

mOl if [ -z "$unaine" ] 

S|)08 then 

1^09 print "Host $machine not found" 

iJilO exit 1 

g=fll fi 

56l2 rsh "$uname" -1 "$ADMIN" "$prog" i awk ' 

^13 NR == 1 {line = $0} 

^014 NR > 1 { print line; line = $0 } 

mis END {if (sub {"-exit line)) exit line; print line; exit -1}' 

ID 16 

_¥fl7 Unloadcf) 
0.1118 appname=$l 
|[|) 1 9 s e t_envi r on 

"©20 cmd-"\$TUXDIR/bin/tmunloadcf " 

'tp21 if [ $# -eq 2 ] 

©22 then 

1023 filenaine=$2 

1024 remote_cmd > "$filename" 

1025 else 

102 6 remote cmd 

1027 fi 

1028 exit $? 
1029 

1030 *) 

1031 echo "Command $1 does not exist" 

1032 exit 1 
1033 

1034 esac 



4i- 
CLAIMS 

1. Process for assisting in the administration of a 
distributed application of a transaction processing manager, 
based on a binary configuration file (TUXCONFIG) , characterized 
in that said process comprises: 

- a step for retrieving information related to said 
application in a configuration file of a master machine (Mm) , 

- a step for checking the consistency of said application 
running on a given machine. 

2. Process according to claim 1, characterized in that it 
comprises a step for managing at least one listener module (3) of 
any machine of the application from another machine. 

3. Process according to claim 1, characterized in that the 
information related to said distributed application is extracted 
directly from the active configuration file of the master 
machine . 

4. Process according to claim 1, characterized in that the 
step for checking the consistency of said application consists of 
a comparison between the information obtained from the 
configuration file of the master machine and the information 
obtained from said current application running on a given 
machine . 



5. Process according to claim 2, characterized in that 
administration of the listener modules consists of starting 
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and stopping at least one listener module, displaying information 
related to at least one listener module, changing the log of at 
least one listener module, checking the script of at least one 
listener module and/or updating the script of at least one 
listener module. 

6. Process according to claim 2, characterized in that it 
comprises a step for starting and stopping a listener module 
running on a first machine, this step being carried out by an 
administrator using a second machine distinct from the first one, 
belonging to the same network as the first machine. 

7. Process according to claim 2, characterized in that it 
comprises a step for simultaneously activating several listener 
modules . 

8. Process according to claim 1, characterized in that it 
comprises a step for decompiling the active configuration file of 
the master machine. 

9. Process according to claim 2, characterized in that the 
steps of the process are implemented by means of a graphical 
interface comprising at least one icon, at least one menu and at 
least one dialog box. 

10. Process according to claim 9, characterized in that the 
menus of the graphical interface are structured in tree form and 
the activation of a menu results in the display of a list of 
values of the current configuration, selectable by the user. 



11. Process according to claim 4, characterized in that 
when the file containing information on said application running 
on a given machine (tlog) does not exist, the process generates 
it automatically in order to be able use it during the next 
startup of the listener modules (3) . 

12. Process according to claim 6, characterized in that 
said displayed information related to at least one listener 
module (3) comprises at least the name of said application, the 
logical name of the machine (LMID) on which said application is 
run, the identification of the user (UID) of said application, 
the address used by the listener module (NLSADDR) , the access 
path to the network of said application, and the access path to 
the log file of said listener module (LLFPN) . 
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ABSTRACT 



The present invention relates to a process for assisting in 
the acaministration of a distributed application of a transaction 
processing manager based on a binary configuration file 
(TUXCONFIG) , characterized in that said process comprises: 

- a step for decompiling the active configuration file of 
the master machine (Mm) , 

- a step for retrieving information from the decompiled 
configuration file of the master machine, 

- a step for checking the consistency of said application 
running on said given machine. 
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En tant qu' inventeur nomme ci-apres, Je deciare par le pre- As a beiow named inventor, i hereby declare that: 
sent acte que: 

Mon nom, mon domicile, mon adresse postale, ma nationalite My residence, post office address and citizenship are as stated 

sont ceux qui figurent ci-apres, below next to my name. 

Je deciare que je crois etre Tinventeur original, premier et 

unique {si un seui nom figure sur le present acte) ou un des 

co-inventeurs, originaux et premiers (si plusieurs noms fi- 
™ gurent sur le present acte) du sujet revendique et pour iiquel 
^ un brevet est demande sur la base de invention intituiee: , 

y Procede dassistance a I'administration d'une 

application distribuee basee sur un fichier binaire 
j|5 de configuration dans un systeme infomiatiq ue. 

the specification of which 
(check one) 

□ is attached hereto. 

□ was filed on as 

Application Serial No 

and was amended on 

(if applicable) 



I believe I am the original, first and sole inventor (if only one 
name is listed below) or an original, first and joint inventor (if 
plural names are listed below) of the subject matter which is 
claimed and forwhichapatent is soughtonthe invention entitled 



dont ia description 

(cocher !a case correspondante) 

(2 est annexee au present acte. 
□ a ete deposee 



Numero de serie de la demande . 
et modifiee le 



(si approprie) 



Je declare par le present acte avoir examine et compris le 
contenu de la description identifiee ci-dessus, revendications 
y compris, et le cas echeant telle que modifiee par I'amend- 
ment cite plus haut. 



I hereby state that I have reviewed and understand the con- 
tents of the above identified specification, including the claims, 
as amended by any amendment referred to above. 



Je reconnais le devoir de divulguer t'information qui est en 
rapport avec I'examen de cette demande selon Titre 37 du 
Code des Reglements Federaux §1 .56(a). 



i acknowledge the duty to disclose information which is ma- 
terial to the examination of this application in accordance with 
Title 37, Code of Federal Regulations, § 1.56(a). 
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Je revendique par ie present acte le benefice de priorite 
etrangere seion Titre 35. du Code des Etats-Unis, §119 de 
toute demande de brevet ou d'attestation d'inventeur enu- 
meree ci-apres. et j'ai identifie egalement ci-apres toute de- 
mande etrangere de brevet ou d'attestation d*inventeur ayant 
une date de depot anterieure a ceile de la demande pour 
laqueile la priorite est revendiquee. 



I hereby claim foreign priority benefits under Title 35, United 
States Code, §1 19 of any foreign application{s) for patent or 
inventor's certificate listed below and liave also identified 
below any foreign* application for patent or inventor's certifi- 
cate having a filing date before that of the application on 
which priority is claimed: 



Prior foreign applications 

Demande(3) de brevet anterieure(s) dans un autre pays: 

97 16699 FRANCE 30,12,1997 



Priority claimed 

Droit de priorite 
revendique 



(Number) 
(Numero) 



(Country) 
(Pays) 



(Day/MonthA'ear RIed) 
(Jour/Mois/Annee de depot) 



res 
Out 



^0 

Non 



(Number) 
(Numero) 



(Country) 
(Pays) 



(Day/MonthA'ear Rled) 
(Jour/Mois/Annee de depdt) 



Yes 
Qui 



(Number) 
(Numero) 



(Country) 
(Pays) 



(Oay/Month/Year Filed) 
(Jour/Mois/Annee de depot) 



Qui 



Non 
Non 



Je revendique par le present acte, !e benefice selon Titre 35 
dii Code des Etats-Unis, §120 da toute(s) demande(s) ame- 
ricaines enumeree(s) ci-apres ei; dans la mesure ou le sujet 
de chacune des revendications de cette demande n'est pas 
divulgue dans la demande americaine anterieure, de la fagon 
definie par le premier paragraphe de Titre 35 du Code des 
Etats-Unis, §112. je reconnais le devoir de divulguer Tinfor- 
mation pertinente selon Titre 37 du Code des Regiements 
Federaux, § 1.56(a). toute information qui se presente entre 
la date de depot de la demande anterieure et la date de depot 
de la demande. soit nationale. soit internattonaie PCT. 



I hereby claim the benefit under Title 35, United States Code, 
§120 of any United States application(s) listed below and, 
insofar as the subject matter of each of the claims of this 
application is not disclosed in the prior United States appli- 
cation in the manner provided by the first paragraph of Title 
35, United States Code, §112. I acknowledge the duty to 
disclose material information as defined in Title 37, Code of 
Federal Regulations, §1 .56(a) which occurred between the 
filing date of the prior application and the national or PCT 
international filing date of this application: 



(Application Serial No.) 
(No. de Demande) 



(Filing Date) 
(Datede04p6t) 



(Etat) 
(brevetee, pendante, 
ak>andonne) 



(Status) 
(patented, pending, 
abandoned) 



(Application Serial No.) (Rling Date) 

(No, de Demande) (Date de Depdt) 

Je declare par le present acte que toutes mes declarations. 
k ma connaissance. sont vraies et que toutes les declarations 
faites a partir de renseignements ou de suppositions, sont 
tenues pour etre vraies; de plus, toutes ces declarations ont 
ete faites en sachant que de fausses declarations volontaires 
u autres actes de meme nature sont sanctionees par une 
amende ou un emprisonnement. ou les deux, selon la Section 
1001, du Titre 18 de Code des Etats-Unis et que de seiles 
declarations deliberement fausses peuvent compromettre la 
validite de la demande ou du brevet delivre. 



(Etat) (Status) 
(brevetee. pendante. (patented, pending, 

abandonnee) abandoned) 

1 hereby declare that ail statements made herein of my own 
knowledge are true and that all statements made on infor- 
mation and belief are believed to be true; and further that ' 
these statements were made with the knowledge that willful 
false statements and the like so made are punishable by fine 
or imprisonment, or both, under Section 1001 of Title 18 of 
the United States Code and that such willful false statements 
may jeopardize the validity of the application or any patent 
issued thereon. 
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POUVOIR: En tant qu'inventeur, je designe r(les) avocat{s) 
et/ou i'(ies) agent(s) suivant{s) pour poursuivre la procedure 
de cette demande et traiter toute affaire la concernant supris 
du Bureau des Brevets et de Marques: 

O Harold L. Stowell, Reg. X7,233 ^ 
Edward J. Kondracki, Reg. 20.604 
Dennis P. Clarke, Reg. 22.549 
William L. Feeney, Reg. 2^. 91 R 
John C. Kerins, Reg, 32,421 



POWER OF ATTORNEY: As a named inventor, 1 hereby 
appoint the following attomey(s) and/or agent(s) to prosecute 
this application and transact all business in the Patent and 
Trademark Office connected therewith, (list name and reg- 
istration number) 

Harold L. Stowell, Reg. 17,233 
Edward J. Kondracki, Reg. 20,604 
Dennis P. Clarke, Reg. 22,549 
William L. Feeney, Reg. 29,918 
John C. Kerins, Reg. 32,421 



Adresser toure correspondance a: 


Send Correspondence to: 


Edward J. Kondracki, Esq. 


Edward J. Kondracki, Esq. 


j:erkam, stowell, kondracki 


KERKAM, STOWELL, KONDRACKI 


ri CLARKE* P.C. 


5t CLARKE, P.C. 


Ji 5203 Leesburg Pike, Suite 600 


5203 Leesburg Pike, Suite 600 


Id '^" Falls-ilhurch, VA 22041 


Falls Church, VA 22041 



g^dresser toute communication telephonique k: . Direct Telephone Calls to: {name and telephone number) 

f^om) (Numero de telephone) 



Edward J. Kondracki, Esq. Edward J. Kondracki, Esq. 

(703) 998-3302 (703) 998-3302 



i 


Nom complet du seul ou premier inventeur 

Baillif Christian ^ 


Fuil name of sole or first inventor 


Signature de P^^^L^J^^^^^-^ ^ Oate 


Inventor's signature Date 


7 bis, avenue du Petit Chambord, Rourq la Rein^, 


Residence 




Nattonaiite France 
Francaise 


Citizenship ' 


A'dresse Postale 

7 bis, avenue du Petit Chambord, Bourq la Reine, 


Post Office Address 


France 




j^Nom complet du second co-inventeur, le cas echeant 
Dia Mama Saidou 


Full name of second joint inventor, ff any 


Signature de rinventeur « Date 


Second Inventor's signature Date 


Domicile *' 

181, avenue Jean Jaures, 92290 Chat^nay Malahry 


Residence ^/C^ 


Nationafite France 
Fran9aise 


Citizenship 


Adresse Postale 

181 . avenue Jean Jaures, 92290 Chatenay Malabry, 


Post Office Address 


France 





(Fournir ies memes renseignennents et la signature de tout (Supply similar information and signature for third and sub- 
co-inventeur supplementaire.) sequent joint inventors.) 
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